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This  thesis  contained  generous  amounts  of  hardware  and 
software  engineering  for  two  quite  different  computer 
systems.  Accomplishing  a  project  of  this  magnitude  as  a 
team  effort  is  quite  probably  the  only  timely  way  to  achieve 
a  satisfactory  capability.  Since  we  both  enjoy  working  with 
projects  that  involve  hardware  and  software  engineering,  we 
feel  that  this  thesis  was  well  suited  for  us  and  that  our 
team  effort  has  provided  the  best  possible  outcome. 
Nevertheless,  we  feel  the  project  was  quite  challenging  and 
very  interesting. 

To  interface  the  8-bit  Cromemco  S-100  bus  system  to  the 
16-bit  Nova  system  required  developing  considerable  insight 
into  the  detailed  operation  of  the  hardware  and  software  of 
both  systems.  As  usual  in  projects  of  this  type  the 
hardware  development  went  rather  quickly.  Most  of  our  time 
was  spent  developing  the  Nova  and  Cromemco  software. 

To  provide  a  systematic  approach  to  solving  possible 
problems,  Captain  Beasley  concentrated  most  of  his  effort 
toward  the  Cromemco  portion  of  the  project  while  Captain 
Fredal  devoted  his  effort  toward  the  Nova.  We  both  spent  a 
large  part  of  our  time  working  together  during  the 
development  of  the  Channel  Protocol.  With  the  concentrated 
knowledge  each  of  us  had  of  our  system,  we  were  able  to 
resolve  potential  conflicts  in  the  protocol  that  could  have 
caused  degraded  operation  within  either  of  the  systems. 
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completion  of  this  thesis  possible. 
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Abstract 

As  a  result  of  the  software  and  hardware  developed 
under  this  thesis,  the  AFIT  Speech  Lab's  Cromemco  Z-2  micro¬ 
computer  system  now  serves  as  an  I/O  Channel  for  the  Lab's 
Nova  2  minicomputer  system.  Since  the  Cromemco  utilizes  the 
S-100  bus,  the  I/O  Channel  provides  considerable  interface 
flexiblity  for  the  Nova  from  the  large  number  of  relatively 
inexpensive  interfaces  available  for  S-100  based  systems. 

The  hardware  developed  to  connect  the  two  systems 
allows  16-bit  information  to  be  transferred  between  both 
systems  even  though  the  Cromemco  is  based  on  an  8-bit  micro¬ 
processor.  In  addition  to  this  hardware  an  I/O  Channel 
Protocol  was  developed  that  allows  the  Nova  to  initiate 
tasks  in  the  Cromemco  and  to  command  data  transfers  between 
itself  and  the  Cromemco  system.  The  necessary  software  was 
also  developed  for  both  systems  to  implement  this  protocol. 
The  Nova's  software  is  structured  so  that  new  capabilities 
can  be  added  in  the  Cromemco  portion  of  the  I/O  channel 
without  the  necessity  of  making  changes  to  the  Nova 
software.  The  software  for  the  Cromemco  is  a  complete 
Channel  Operating  System  that  allows  task  modules  to  be 
added  as  separately  linkable  routines  when  new  requirements 
are  placed  upon  the  I/O  Channel.  These  modules  can  be 
easily  added  and  should  not  require  changes  to  the  primary 
operating  system  that  handles  the  basic  I/O  Channel 
Protocol . 
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AN  ANALOG  SPEECH  I/O  CHANNEL  FOR  THE 
NOVA  2  COMPUTER  BASED  ON  THE  S-100  BUS 


I.  Introduction 

This  thesis  involves  the  design  of  an  interface  between 
the  Cromemco  Z-2  microcomputer  and  a  Nova  2  minicomputer. 
When  this  interface  is  used  with  the  software  written  for 
both  systems,  it  provides  an  I/O  Channel  for  the  Nova.  This 
was  done  initially  to  provide  a  speech  I/O  capability  for 
the  system.  The  requirement  was  later  upgraded  to  provide  a 
generalized  I/O  Channel  capability.  Chapter  One  discusses 
the  background  for  the  project  and  the  basic  configuration 
of  both  systems.  Chapter  Two  provides  insight  into  the 
initial  problems  that  were  addressed  and  the  final  design 
that  was  implemented.  Chapter  Three  includes  the  actual 
design  implementation  and  the  theory  of  operation  of  the  I/O 
Channel.  Chapter  Four  discusses  the  conclusions  and  recom¬ 
mendations  of  the  design  team. 

background 

The  Electrical  Engineering  department  of  the  Air  Force 
Institute  of  Technology  (AFIT)  wishes  to  develop  a  general 
purpose,  digital  speech  processing  facility.  This  facility 
already  includes  an  Eclipse  S/250  minicomputer,  a  Nova  2 
minicomputer  with  an  expansion  chassis  and  a  Cromemco  Z-2 
microcomputer  system.  Both  minicomputers  are  16-bit 
machines  built  by  the  Data  General  (DG)  Corporation.  The 
Cromemco  system  has  a  Z-80  Central  Processing  Unit  (CPU)  and 


is  based  on  the  S-100  bus.  The  two  minicomputers  share  a 
ten  megabyte  hard  disk  (Model  No.  6045)  through  an  Inter- 
Processor  Buffer  (IPB)  which  arbitrates  simultaneous 
accesses.  The  system  also  includes  a  tape  drive  (Model  No. 
6021),  two  terminals,  and  a  high  speed  dot  matrix  printer. 

One  of  the  first  tasks  that  the  facility  is  required  to 
support  is  the  development  of  a  speech  encoding  algorithm 
which  will  reduce  the  number  of  bits  required  to  transmit 
digitized  speech.  This  will  allow  increased  rates  of  speech 
transmission  over  currently  available  communications  net¬ 
works.  Another  task  will  be  to  develop  highly  accurate 
speech  recognition  algorithms  for  an  aircraft  cockpit  capa¬ 
ble  of  responding  to  a  pilot's  verbal  commands.  In  the  past 
all  digital  speech  work  at  AFIT  was  done  on  a  remote  main¬ 
frame  computer.  Unfortunately  this  technique  involved 
intolerable  turnaround  delays  and  resulted  in  the  develop¬ 
ment  of  a  dedicated  speech  facility.  With  a  dedicated  proc¬ 
essing  capability,  these  delays  could  be  greatly  reduced  to 
allow  nearly  real-time  processing  to  be  accomplished. 

It  was  decided  to  use  a  Cromemco  1-2  system  to  provide 
the  speech  data  acquisition  capability  for  the  facility, 
even  though  DG  manufacturers  such  peripherals.  There  were 
three  reasons  for  this  decision.  First,  the  DG  peripherals 
required  more  funds  than  had  been  allocated.  Obtaining 
additional  funding  would  have  resulted  in  a  delay  that  would 
have  caused  most  thesis  work  in  the  lab  to  stop  until  the 
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1981  cycle.  Second,  hardware  for  the  S-100  bus,  capable  of 
performing  a  wide  range  of  functions,  is  available  from  many 
manufacturers.  This  reduces  the  cost  of  the  system  itself 
and  the  cost  of  adding  enhanced  capabilities  in  the  future. 
Third,  the  S-100  bus  in  the  Cromemco  makes  future  upgrade  in 
capability  a  relatively  easy  task.  This  is  due  to  the  large 
number  of  boards  currently  manufactured  for  the  bus  and  the 
fact  that  most  upgrades  simply  require  the  purchase  of  the 
hardware  and  development  of  software  drivers  for  it. 

The  Cromemco  system  includes  a  Cromemco  Z-80  CPU  Board 
and  4FDC  Disk  Controller  Board;  a  Seimens  5-inch  mini-floppy 
Disk  Drive;  two  Seattle  Computing  16/8  RAM  16K  memory  boards 
and  a  CPU  Support  Card;  and  a  Techmar  S-100  A/D  Board,  D/A 
Board,  and  Video  Digitizer.  The  Video  Digitizer  was  used  by 
another  thesis  project.  The  16/8  RAM  memory  meets  the  IEEE 
standard  for  the  S-100  bus  and  allows  both  16-  and  8-bit 
data  transfers.  The  CPU  Support  Card  provides  crystal 
controlled  timers,  interrupt  controllers,  a  parallel  input 
and  output  (I/O)  port,  and  a  bidirectional  serial  port.  The 
S-100  A/D  board  uses  an  Analogic  MP6812  16-channel  A/D 
converter  with  a  resolution  of  12  bits  and  an  approximate 
conversion  time  of  35  microseconds.  The  D/A  board  has  four 
separate  D/A  converters  ( DAC- 80-CB I- V) .  Each  of  these  D/A 
converters  has  a  resolution  of  12  bits  and  a  conversion  time 
of  approximately  3  microseconds. 
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Problem 

The  problem  solved  by  this  thesis  was  the  design  and 
implementation  of  an  S-100  based  I/O  Channel  with  an  initial 
capability  of  speech  I/O  for  the  Nova  2.  The  key  word  here 
is  "Channel."  Under  this  concept  the  Nova  is  required  to 
initiate  all  I/O  transactions.  Also,  the  Cromemco  must  be 
completely  transparent  to  the  Nova  user  when  it  is  involved 
in  an  I/O  process.  The  only  concern  the  user  should  have  is 
to  insure  the  Cromemco's  power  is  turned  on. 

An  additional  requirement  for  this  project  was  to 
insure  that  future  upgrades  to  the  system  are  as  simple  as 
possible.  Such  upgrades  could  be  very  complex  processes  if 
knowledge  of  both  the  Nova  and  Cromemco  assembly  languages 
and  operating  systems  were  required.  Therefore,  the  inter¬ 
face  and  associated  software  were  to  be  designed  to  allow 
upgrades  with  no  software  changes  required  in  the  Nova.  This 
can  allow  a  person  who  is  only  familiar  with  the  Z-80  pro¬ 
cessor  to  accomplish  the  system  modification  or  enhancement. 
In  addition,  the  operating  system  developed  for  the  Cromemco 
must  be  easy  to  enhance.  It  should  not  be  necessary  to 
change  the  operating  system  in  order  to  add  a  new  capability 
to  the  I/O  Channel. 

General  Apprpgcb 

First,  the  hardware  interfaces  to  connect  the  two 
systems  were  designed  and  built.  These  interfaces  had  to 
provide  for  both  programmed  I/O  and  Direct  Memory  Access 
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(DMA)  of  data  from  the  Nova.  Status  and  command  words  were 
to  be  passed  between  the  two  systems  by  programmed  I/O  with 
bulk  data  transfers  being  done  with  DMA.  The  DMA  was  to  be 
between  the  Nova  and  the  latches  in  its  interface  and  not 
between  the  Nova  and  Cromemco  memories.  A  DMA  directly  into 
the  Cromemco  memory  was  not  necessary  to  meet  the  require¬ 
ments  for  speech  I/O.  It  should  be  noted  that  DMA  within 
the  Nova  is  referred  to  as  a  Data  CHannel  (DCH)  by  DG.  DCH 
will  therefore  be  used  to  signify  the  DMA  operation  of  the 
Nova  to  distingush  it  from  a  DMA  within  the  Cromemco  system. 

Next  a  primitive  means  of  speech  I/O  was  developed  to 
allow  other  students  working  on  speech  processing  oriented 
theses  to  obtain  the  data  they  required.  This  preliminary 
speech  I/O  was  accomplished  by  using  programmed  I/O  and  by 
buffering  the  data  in  the  Cromemco  rather  than  using  the 
DCH.  The  DCH  would  have  taken  much  too  long  to  develop 
since  it  required  both  hardware  and  software  development  for 
the  Cromemco  to  employ  this  capability.  The  major  disadvan¬ 
tage  of  this  first  implementation  was  that  buffering  the 
speech  data  in  the  Cromemco  limited  the  amount  of  data  which 
could  be  converted  at  any  one  time  to  three  seconds.  Also, 
without  the  operating  system  in  the  Cromemco,  a  separate 
program  had  to  be  run  in  each  computer  to  convert  the 
speech. 


Finally,  the  operating  system  was  written  for  the 
Cromemco  and  software  was  written  for  the  Nova,  which 
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includes  implementation  of  the  DCH  transfer  of  speech  data. 
This  allowed  the  speech  data  to  be  passed  to  and  from  the 
Nova’s  disk  under  full  control  of  the  developed  software. 
This  final  implementation  accomplished  the  requirements  that 
were  established  for  the  I/O  channel. 


II. 


This  chapter  briefly  describes  the  Nova  and  Cromemco 
systems.  It  includes  a  discussion  of  the  interface  hardware 
and  software  designs  necessary  for  both  systems  to  be 
interconnected.  Also  included  is  a  description  of  the 
speech  channel  communication  protocol  that  was  required. 

Nova  System 

The  Nova  minicomputer  consists  of  a  chassis  with  a 
built-in  power  supply  and  a  backplane  with  ten  slots  into 
which  a  CPU  board,  memory  boards,  and  I/O  interface  boards 
can  be  inserted.  Each  slot  has  two  100-pin  edge-connect 
sockets  to  connect  the  boards  to  busses  and  control  lines 
which  are  on  the  backplane.  Forty-eight  of  the  100  pins  are 
reserved  to  carry  signals  to  paddle  boards  located  along  the 
back  edge  of  the  backplane.  Peripheral  devices  are 
connected  through  these  paddle  boards  to  the  circuitry  of 
the  I/O  interface  boards.  Since  all  ten  slots  in  the  Speech 
Lab's  Nova  were  already  in  use,  an  expansion  chassis  was 
added.  It  provides  ten  additional  slots  which  can  be  used 
by  I/O  interface  boards  and  includes  its  own  power  supply. 
The  I/O  bus  in  the  main  chassis  is  connected  to  the  expan¬ 
sion  chassis's  backplane  through  the  appropriate  connector 
and  a  set  of  buffers.  There  are  two  paddle  boards  built 
into  the  backplane  of  the  expansion  chassis,  one  for  slot 
one  and  one  for  slot  ten.  The  I/O  boards  perform  equally 
well  in  the  expansion  chassis  as  in  the  main  chassis  except 
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for  those  requiring  the  high  speed  Data  CHannel  (DCH).  Only 
the  low  speed  DCH  can  be  implemented  from  the  expansion 
chassis. 

DG  has  succeeded  in  creating  an  I/O  system  that  is 
relatively  easy  to  interface  to  as  well  as  to  program.  In 
order  to  better  understand  how  the  Nova  I/O  system  works, 
it  is  necessary  to  examine  the  structure  of  the  Nova's  I/O 
bus.  It  is  a  well  designed,  relatively  uncomplicated  system 
consisting  of  a  16-bit  bidirectional  data  bus,  a  6-bit 
device  select  bus,  seven  DCH  control  lines  and  fifteen 
control  signals  to  handle  programmed  I/O  and  interrupts.  DG 
refers  to  an  I/O  interface  board  and  its  associated 
peripheral  as  a  device.  Therefore,  all  future  references  to 
a  device  assume  this  convention.  The  processor  selects  a 
device  by  placing  its  code  on  the  device  select  bus.  The 
device  decodes  the  device  select  bus  and  generates  a  device 
select  signal  which  is  used  to  gate  all  control  signals  into 
or  out  of  the  I/O  interface  board.  Each  device  can  have  up 
to  three  separate  ports  (A,  B,  and  C)  with  which  to 
communicate  with  the  system.  Each  port  is  generally 
composed  of  two  separate  16-bit  registers,  one  for  output 
and  one  for  input. 

Each  device  has  a  BUSY  flag  and  a  DONE  flag  associated 
with  it.  The  BUSY  flag  is  set  when  the  device  is  "started" 
or  put  to  work  on  a  task  by  the  processor.  When  the  device 
has  completed  the  task  it  sets  the  DONE  flag.  The  processor 
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can  examine  each  flag  individually.  It  can  set  the  BUSY 
flag,  which  also  clears  the  DONE  flag,  or  it  can  clear  both 
flags  simultaneously.  When  both  flags  are  cleared  the 
device  is  considered  idle. 

The  data  transfer  capabilities  of  the  I/O  bus  includes 
both  programmed  I/O  and  the  DCH.  Programmed  I/O  is  handled 
directly  by  the  Nova  processor,  while  the  DCH  is  handled  by 
hardware  designed  to  maximize  the  speed  of  the  transfer. 
Normally,  programmed  I/O  is  used  to  transfer  data  when  it  is 
necessary  for  the  processor  to  examine  or  process  each  word 
as  it  is  passed  through  the  interface  or  when  it  is 
necessary  to  handshake  with  the  device  after  each  data 
transaction.  The  BUSY  and  DONE  flags  are  used  to 
synchronize  the  transfer  of  data  by  programmed  I/O. 

Since  the  DCH  is  a  much  faster  data  transfer  operation 
than  programmed  I/O,  it  allows  a  large  amount  of  data  to  be 
transferred  in  a  very  short  period  of  time.  There  are  two 
speeds  under  which  DCH  transfers  can  be  made.  The  high 
speed  DCH  transfers  data  at  a  maximum  rate  of  approximately 
1,250,000  words  per  second,  while  the  maximum  rate  for  low 
speed  DCH  transfers  is  approximately  475,000  words  per 
second.  These  speeds  are  achieved  through  the  direct 
transfer  of  data  between  the  Nova’s  memory  and  a  device's 
port.  The  initiation  and  direction,  either  input  or  output, 
of  a  DCH  is  set  by  the  device.  However,  the  parameters  of 
the  transfer  must  first  be  set  up  by  the  Nova  processor. 
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The  Nova  must  load  the  address  register  of  the  device  with 
the  starting  address  of  the  area  of  memory  to  be  trans¬ 
ferred.  It  can  also  load  the  two's  complement  of  the  number 
of  words  to  be  transferred  into  the  word  count  register  of 
the  device.  Both  registers  are  incremented  by  one  each 
time  a  word  is  transferred.  The  processor  uses  the  address 
register  of  the  interface  to  determine  the  memory  location 
involved  in  the  transfer  of  each  word.  Since  the  device 
initiates  the  DCH  request  for  each  transfer,  it  can  use  the 
word  count  register  to  determine  when  the  transfer  is 
complete.  Priority  for  the  Data  Channel  is  established  by 
daisy  chaining  the  Data  Channel  Priority  control  line.  The 
device  which  is  physically  closest  to  the  processor  in  the 
chain  receives  the  highest  priority. 

Although  the  Nova  I/O  bus  can  handle  interrupts,  this 
capability  was  not  required  in  the  implementation  of  the  I/O 
channel;  therefore,  Nova  interrupts  will  not  be  discussed. 

Cromemco  System 

Since  both  the  Nova  and  Cromemco  systems  are  stand 
alone  computers,  they  appear  similar  in  many  respects,  but 
they  are  actually  quite  different.  The  Cromemco  system 
consists  of  a  chassis  housing  a  built-in  power  supply  and  an 
S-100  bus  mother-board  made  up  of  twenty-one  100-pin  connec¬ 
tors.  Each  of  these  connectors  provides  a  slot  into  which 
S-100  compatible  circuit  cards  can  be  inserted.  Unlike  the 
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Nova,  each  of  the  slots  on  the  Cromemco  mother-board 
receives  the  same  set  of  signals;  therefore,  any  circuit 
card  that  is  compatible  with  the  S-100  bus  can  be  plugged 
into  any  of  the  slots.  Consequently,  there  are  no  special 
or  reserved  slots  in  the  Cromemco  system.  The  only 
consideration  that  must  be  made  is  that  no  more  than  one 
card  can  be  assigned  to  the  same  memory  and/or  I/O 
addresses.  The  built-in  power  supply  provides  three 
unregulated  voltages  (+8,  -18,  and  +18  volts)  to  the  bus. 
It  is  the  responsibility  of  each  circuit  card  inserted  into 
a  slot  to  have  its  own  on-board  regulators  capable  of 
supplying  the  power  required  by  the  circuit. 

The  S-100  bus  has  become  one  of  the  most  popular  hobby 
busses  and  is  now  considered  by  most  as  an  industry 
standard.  It  was  first  introduced  by  MITS,  Inc.  (now  part 
of  the  Pertec  Computer  Co.)  on  their  8080-based  Altair 
computer.  Since  it  was  originally  designed  to  support  the 
8080  processor,  most  of  the  bus  signals  are  representative 
of  the  signals  generated  by  an  8080  processor.  Almost  all 
of  the  100  lines  of  the  bus  have  a  standardized  predefined 
function  (see  Appendix  A).  Basically,  the  lines  can  be 
divided  into  four  major  groups.  These  groups  consist  of 
power  and  ground  lines,  address  lines,  data  lines,  and 
control  lines. 

The  power  and  ground  line  group  provides  the  voltages 
required  by  the  computer.  Six  lines  are  assigned  to  provide 
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the  three  unregulated  voltages  and  their  ground  returns. 
The  address  line  group  provides  the  sixteen  lines  required 
to  supply  a  16-bit  memory  address.  The  data  line  group  is 
composed  of  sixteen  lines  and  is  used  to  supply  program 
instructions  and  data.  Normally,  the  data  group  lines  are 
separated  into  two  sub-groups  of  eight  lines  each.  One  set 
is  used  to  supply  data  to  the  CPU,  while  the  other  set  is 
used  for  data  eminating  from  the  CPU.  A  recent  document 
that  the  Institute  of  Electrical  and  Electronics  Engineers 
(IEEE)  has  published  allows  these  sixteen  lines  to  become 
bidirectional  when  the  proper  control  signals  are  provided 
(see  Appendix  A).  This  allows  the  bus  to  be  used  with  the 
evolving  16-bit  micro-processors.  This  document  is  heralded 
as  a  standard  and  should  serve  to  standardize  the  bus  across 
the  industry  for  both  8-bit  and  16-bit  operation.  The 
remaining  sixty-two  lines  comprise  the  control  line  group. 
These  lines  are  used  to  carry  timing  and  control  signals 
between  the  CPU,  memory  and  I/O, 

With  the  already  overwhelming  acceptance  of  the  S-100 
bus,  made  evident  by  the  extent  of  its  use,  it  is  an  ideal 
choice  as  the  computer  bus  for  the  I/O  channel.  There  are 
numerous  manufacturers  building  cards  that  comply  with  the 
standard,  making  the  task  of  finding  a  commercially  built 
card,  to  do  all  but  the  most  specialized  functions,  quite 
easy.  Since  many  manufacturers  are  generating  large 
quantities  of  cards,  the  cost  is  considerably  less  than  an 
equivalent  device  designed  specifically  for  the  Nova  bus. 
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Since  the  S-100  bus  is  a  true  parallel  bus,  all  signals 
within  the  system  are  available  to  any  card  placed  on  the 
bus.  This  provides  for  nearly  unlimited  use  of  these 
signals  by  an  interface  or  I/O  peripheral.  The  Nova's  bus 
tends  to  be  more  restrictive  in  this  case,  since  it  requires 
certain  modules  to  be  placed  into  certain  slots.  Since  the 
S-100  bus  is  not  as  tightly  structured  as  the  Nova’s  bus, 
the  Cromemco  system  handles  I/O  differently  than  the  Nova. 
The  Cromemco’s  S-100  bus  is  capable  of  communicating 
directly  with  256  I/O  ports  using  the  low  byte  of  its 
address  bus  rather  than  a  special  device  select  bus  like  the 
Nova.  The  S-100  bus  has  two  control  lines  that  delineate 
I/O  operations  from  normal  memory  transactions.  One  of 
these  lines,  sINP,  indicates  an  input  operation  while  the 
other,  sOUT,  indicates  an  output  operation.  Each  interface 
must  decode  the  least  significant  byte  of  the  16-bit  address 
bus  to  determine  its  port  addresses  when  either  of  these  two 
I/O  signals  appear.  Two  other  control  signals,  pWR  and 
pDBIN,  are  always  generated  during  memory  write  and  read 
operations,  respectively.  These  signals  are  used  to  tell 
the  interface  circuit  when  it  must  either  supply  data  to  or 
take  data  from  the  system. 


The  CPU  Support  Card  was  selected  from  the  commercially 
available  interfaces  for  the  S-100  bus  to  provide  the 
Cromemco  with  a  set  of  crystal  controlled  timers  and 
interrupt  control  circuitry.  The  timers  which  are  accurate 
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to  250  nanoseconds  and  the  interrupt  circuitry  are  used  to 
maintain  the  precise  timing  required  for  sampling  analog 
speech  or  reconstructing  digitized  speech.  Since  slight 
variations  in  the  sampling  rate  can  cause  the  speech  to 
become  distorted,  it  is  imperative  that  the  sampling  rate  is 
kept  constant  when  accomplishing  either  of  these  operations. 
To  insure  an  exact  rate,  a  crystal  controlled  timer  on  the 
CPU  Support  Card  is  used  to  interrupt  the  system  when  each 
sample  must  be  taken.  These  interrupts  cause  the  CPU  to 
service  the  appropriate  A/D  or  D/A  converter  at  programmable 
time  intervals  set  for  the  required  sampling  rate. 

Nova  Interface  Hardware 

The  interface  circuit  for  the  Nova  was  built  on  a  DG 
General  Purpose  Interface  (GPI)  board.  This  board  provides 
circuitry  which  can  be  used  to  implement  most  of  the  three 
previously  described  ports,  the  BUSY  and  DONE  flags,  the 
interrupt  control  function  and  the  DCH  control  function.  In 
addition,  the  board  has  a  breadboard  area  to  allow  the 
addition  of  custom  circuitry.  The  pre-wired  circuits,  along 
with  any  required  custom  circuitry,  must  be  connected 
together  to  create  the  desired  interface  for  the  peripheral 
device. 


In  order  for  the  GPI  to  serve  as  an  interface  to  the 
Cromemco,  the  on-board  registers  had  to  be  assigned  to  the 
device’s  ports.  The  assignments  were  made  by  connecting  the 


control  signal  of  a  particular  port  to  the  clocks  of  each 
input  and  output  register.  The  DCH  address  register  is 
pre-wired  on  the  board  and  was  assigned  to  the  B  Port.  This 
register  is  different  from  the  others  because  it  is  a  single 
register  serving  as  both  an  input  and  output  register  for 
the  Nova.  This  allows  the  Nova  to  load  the  B  Port  before 
the  first  DCH  is  attempted  and  to  use  its  contents  as  the 
memory  address  for  the  data  to  be  transferred  during  each 
DCH.  The  device,  on  the  other  hand,  can  only  read  this 
register,  not  load  it.  This  register  can  also  be 
incremented,  which  is  a  capability  that  a  DCH  address 
register  must  possess.  An  incrementable  input  register  is 
also  available  on  the  GPI  and  was  assigned  to  the  C  Port. 
This  register  was  intended  to  be  used  as  the  word  counter 
during  a  DCH  but  the  Cromemco  tracks  the  count  internally, 
so  it  is  used  simply  as  an  input  register.  The  remaining 
pre-wired  input  register  and  output  register  were  assigned 
to  the  A  Port.  At  this  point,  only  the  A  Port  provides  a 
complete  bidirectional  path  to  the  Nova  processor.  In  order 
for  programmed  command  I/O  word  to  be  transferred  to  the 
Cromemco  while  DCH  is  in  operation,  two  completely 
separate  bidirectional  paths  to  the  device  were  required. 
Since  the  A  Port  is  fully  utilized  during  a  DCH,  an  output 
register  was  added  to  the  GPI  for  the  C  Port  in  order  to 
make  it  bidirectional.  The  additional  circuitry  to 
accomplish  this  was  added  using  the  breadboard  area  provided 
on  the  GPI. 
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A  paddle  board  on  the  backplane  of  the  Nova  expansion 
chassis  is  used  to  connect  the  Nova  to  the  Cromemco.  Since 
there  are  only  forty-eight  connections  available  on  a  paddle 
board  and  some  of  these  are  needed  for  control  purposes,  no 
more  than  two  sets  of  sixteen  lines  can  be  used  for  the  data 
transfer  path.  With  this  constraint,  a  method  of  transfer¬ 
ring  the  three  16-bit  ports  over  two  16-bit  paths  had  to  be 
devised.  Each  path  could  have  been  made  bidirectional, 
which  would  have  provided  two  completely  separate  data 
paths,  or  two  unidirectional  paths  could  have  been  created 
by  allocating  one  path  for  input  and  the  other  path  for 
output.  The  two  unidirectional  path  approach  was  chosen 
since  this  appeared  to  simplify  the  circuitry  in  both  the 
Nova  and  Cromemco  interface  boards.  With  this  configuration 
there  are  no  conflicts  for  the  data  path;  therefore,  no 
additional  data  path  arbitration  circuitry  is  required.  All 
three  ports  are  made  available  to  the  Cromemco  by  tying  all 
of  their  inputs  to  the  input  data  path  and  multiplexing  all 
of  their  outputs  to  the  output  data  path.  This  means  that 
the  B  Port  is  readily  available  should  it  be  required  by  the 
Cromemco  at  a  later  date.  As  indicated  earlier,  this  port 
cannot  be  loaded  by  the  device,  but  the  GPI  breadboard  area 
has  ample  space  for  adding  this  capability  at  a  later  date. 
Cromemco  data  is  demultiplexed  from  the  input  data  path  with 
the  DATA  CLOCK  signal.  This  signal  clocks  the  data  into  the 
input  register  selected  by  the  Cromemco  via  one  of  the 
control  lines  on  the  interface.  The  output  registers  are 


multiplexed  onto  the  output  data  path  through  three  sets  of 
tristate  bus  drivers.  The  Cromemco  selects  the  desired  Nova 
output  register  by  enabling  its  set  of  tristate  drivers  with 
one  of  the  interface  control  lines.  The  register  multiplex¬ 
ing/demultiplexing  circuitry  was  put  in  the  breadboard  space 
provided  on  the  GPI  board. 

The  GPI  device  select  circuitry  was  set  up  to  decode  25 
(octal)  as  a  device  select;  therefore,  the  Cromemco  appears 
to  the  Nova  as  device  number  25.  This  number  was  selected 
to  eliminate  possible  conflicts  with  existing  devices.  The 
BUSY  and  DONE  flags  were  utilized  to  coordinate  the  transfer 
of  data  between  the  two  computers.  The  hardware  to  provide 
the  flags  and  allow  them  to  function  as  prescribed  by  DG  was 
already  available  on  the  GPI.  These  flags  were  also  sent 
to  the  Cromemco  so  they  can  be  monitored.  In  addition,  the 
DEVICE  COMPLETE  input  to  the  Nova  was  made  available  to  the 
Cromemco.  It  is  on  the  low  to  high  transition  of  this 
signal  that  the  DONE  flag  is  set  and  the  BUSY  flag  is 
cleared. 

£r-gJnemoQ  Interface  Hardware 

The  Cromemco  interface  card  provides  the  necessary  I/O 
ports  to  allow  the  8-bit  Cromemco  Z-80  CPU  to  read  or  write 
to  the  16-bit  registers  on  the  Nova  interface  board.  It 
also  provides  an  additional  input  port  to  allow  monitoring 
of  the  Nova’s  BUSY  and  DONE  flags  and  two  additional  output 
ports.  One  of  these  output  ports  allows  the  Cromemco  to 
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initiate  a  DCH  and  the  other  contains  an  8-bit  latch  with 
one  of  its  bits  used  to  inhibit  the  A  Port  DEVICE  COMPLETE 
signal  during  DCH  data  transfers  and  two  other  bits  used 
for  selecting  the  direction  and  type  of  DCH.  The  interface 
generates  the  DATA  CLOCK  signal  used  for  clocking  the  Nova 
ports'  input  registers,  the  three  discrete  control  signals 
used  for  selecting  the  proper  Nova  port,  and  the  DEVICE 
COMPLETE  signal  used  for  setting  the  Nova  DONE  flag.  The 
interface  also  supports  single  operation  16-bit  transfers 
should  this  capability  be  added  to  the  Cromemco  at  a  later 
date.  Therefore,  the  interface  completely  supports  the  new 
IEEE  S-100  bus  standard  (see  Appendix  A).  Unfortunately, 
there  were  no  pre-wired  circuits  that  could  implement  this 
specialized  interface;  therefore,  it  had  to  be  designed, 
fabricated,  and  tested  in-house. 

This  interface  operates  differently  when  it  is  sending 
data  to  the  Nova  than  it  does  when  it  is  receiving  data. 
When  sending  data  the  most  significant  byte  of  the  word  to 
be  transferred  is  stored  in  a  latch  until  the  least 
significant  byte  can  be  sent.  At  the  time  that  the  least 
significant  byte  is  transferred,  the  most  significant  byte, 
due  to  the  latch,  is  already  available  on  the  upper  portion 
of  the  data  transfer  path,  causing  a  complete  16-bit  word  to 
be  transferred  to  the  Nova.  The  order  in  which  the  two 
bytes  are  sent  to  the  Nova  port  is  extremely  important 
because  it  is  during  the  transfer  of  the  least  significant 


byte  that  all  sixteen  bits  are  clocked  into  the  respective 
Nova  input  register  by  the  DATA  CLOCK  signal.  Also,  the 
DEVICE  COMPLETE  signal,  which  is  usually  generated 
simultaneously  with  the  DATA  CLOCK,  clears  the  Nova  BUSY 
flag  and  sets  the  Nova  DONE  flag.  The  circuitry  for 
receiving  16-bit  data  from  the  Nova  is  much  simpler.  Since 
the  Nova  has  the  data  latched  into  one  of  it  output 
registers,  there  is  no  requirement  for  the  Cromemco  to  latch 
this  data.  It  is  available  any  time  the  Cromemco  wishes  to 
read  it.  Therefore,  the  Cromemco  merely  inputs  the  most 
significant  byte  in  one  operation  and  the  least  significant 
byte  in  the  next. 

The  Cromemco  uses  six  of  its  I/O  port  addresses  to 
select  the  proper  byte  of  the  Nova's  A,  B,  or  C  Port 
registers.  Generally,  inputting  from  or  outputting  to  a 
Cromemco  I/O  port  determines  whether  the  Nova  port's  output 
or  input  register,  respectively,  is  selected.  The  I/O  port 
assignments  were  made  with  great  care  to  insure  that  they 
would  not  conflict  with  assignments  already  established  for 
the  standard  Cromemco  1-2  system  and  also  to  provide  an  easy 
association  to  their  Nova  counterparts  during  the  software 
writing  phase  of  the  project  (see  Appendix  B).  Addi¬ 
tionally,  the  memory  chosen  for  the  Cromemco  system  is 
capable  of  operating  under  the  IEEE  standard  for  the  S-100 
bus  which  allows  single  operation  16-bit  memory  accesses  and 
data  transfers.  Unfortunately,  the  Cromemco  system  only 
supports  8-bit  transfers,  but  to  allow  for  potential  system 


improvements  utilizing  a  16-bit  microprocessor  and/or  a 
16-bit  DMA  controller,  the  pairs  of  8-bit  Cromemco  I/O  ports 
used  to  communicate  with  each  of  the  Nova  16-bit  ports  had 
to  be  mapped  contiguously.  With  these  criteria  in  mind,  the 
I/O  ports  were  assigned  in  pairs  so  that  the  Cromemco  I/O 
ports  $A0  -  $A1,  $B0  -  $B1,  and  $C0  -  $C1  corresponded  to 
the  low  and  high  bytes  of  the  registers  of  the  Nova  A,  B, 
and  C  Ports,  respectively.  Hardware  was  also  added  to 
provide  the  16-bit  data  transfer  potential.  The  sixteen 
request  (sXTRQ)  and  the  sixteen  acknowledge  (SIXTN)  signals, 
as  required  by  the  IEEE  standard,  were  implemented  to  allow 
the  pairs  of  contiguous  I/O  ports  to  be  accessed  as  if  they 
were  a  single  16-bit  port. 

To  illustrate  the  technique  implemented  by  the 
interface  for  transferring  16-bit  data  words  to  the  Nova, 
suppose  the  Nova's  C  Port  input  register  is  to  receive  data. 
The  Cromemco  would  first  output  the  most  significant  byte  of 
the  data  word  to  its  $C1  output  port.  This  operation  would 
cause  the  Cromemco  to  latch  this  byte  of  data  on  the  most 
significant  byte  of  the  data  transfer  path  between  the  two 
systems.  Next,  it  would  output  the  least  significant  byte 
of  the  data  word  to  its  $C0  output  port.  This  places  the 
least  significant  byte  on  the  data  transfer  path  so  that  now 
the  entire  16-bit  word  is  present  on  the  data  path.  The 
output  to  $C0  also  generates  the  C  SELECT  signal  which 
allows  the  DATA  CLOCK  signal  to  clock  the  entire  sixteen 
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bits  of  data  into  the  Nova's  C  Port  input  register.  In 
addition,  the  DEVICE  COMPLETE  signal  clears  and  sets  the 
Nova  BUSY  and  DONE  flags,  respectively,  completing  the 
transaction.  When  data  is  to  be  transferred  from  the  Nova 
to  the  Cromemco,  the  transaction  is  much  simpler.  For  a 
transfer  of  this  type,  the  Cromemco  would  simply  accomplish 
an  input  from  its  $C1  input  port  by  generating  the  C  SELECT 
signal.  This  would  cause  the  entire  16-bit  data  word  con¬ 
tained  in  the  output  register  of  the  Nova's  C  Port  to  be 
gated  on  the  data  transfer  path,  but  only  the  most  signifi¬ 
cant  byte  of  this  data  would  be  gated  onto  the  Cromemco's 
data  bus.  An  input  from  the  $C0  input  port  would  cause  the 
same  data  word  to  again  be  placed  on  the  data  transfer  path, 
but  now  the  least  significant  byte  would  be  placed  on  the 
Cromemco's  data  bus.  It  should  be  noted  that  the  order  in 
which  two  bytes  of  data  are  from  the  Nova  is 
inconsequential . 

For  programmed  I/O  handshaking  and  DCH  control  pur¬ 
poses,  three  additional  I/O  ports  were  assigned  in  the 
Cromemco  system.  The  Nova  BUSY  and  DONE  flags  are  accessed 
by  reading  port  $D0.  The  Cromemco's  DCH/DMA  control  regis¬ 
ter  is  loaded  by  an  output  to  port  $D0.  This  control  regis¬ 
ter  has  two  bits  which  activate  the  Nova  DCH  control  lines. 
Another  bit  of  this  control  register  allows  the  DEVICE 
COMPLETE  signal  to  be  disabled  for  all  transfers  from  the 
Cromemco  to  the  Nova  A  Port.  DCH  requests  are  generated  by 
an  output  to  port  $C2.  The  DCH  request  can  only  be 
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generated  if  the  proper  DCH  activation  bit  is  set  in  the 
Cromemco  DCH/DMA  control  register.  The  DCH/DMA  control 
register  has  several  bits  that  have  been  reserved  for 
control  of  Cromemco  DMA  controller  circuitry  that  is  to  be 
added  at  a  later  date. 

1LQ  Channel  Sof  tw ana  ind  Protocol 

The  software  for  the  I/O  Channel  was  developed  in  two 
stages.  The  first  stage  provided  a  quickly  constructed 
crude  capability  for  digitizing  speech  and  for  regenerating 
the  digitized  speech  to  support  the  other  theses  currently 
in  progress.  During  the  second  stage  the  software  to  allow 
the  Nova  to  use  the  Cromemco  as  an  I/O  channel  was 
developed.  The  second  stage  software  duplicated  some  of  the 
first  stage  capability,  but  the  capability  provided  by  the 
first  stage  was  heavily  used  and  therefore,  proved  to  be 
very  worth  while. 

The  original  requirements  to  be  met  for  speech  I/O  were 
a  sample  and  regeneration  rate  of  10  KHz  and  storage  of  the 
speech  data  on  the  Nova's  disk.  During  the  first  stage  two 
routines  were  written  in  the  Cromemco  and  two  companion 
routines  were  written  in  the  Nova  to  accomplish  this.  Each 
pair  of  routines,  one  in  the  Nova  and  one  in  the  Cromemco, 
provided  for  speech  data  to  be  transferred  in  only  one 
direction.  The  two  Cromemco  routines  were  known  as  D2A8K 
which  regenerated  the  speech  and  A2D8K  which  sampled  the 
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speech.  These  routines  set  up  the  timers  and  interrupt 
control  circuits  on  the  CPU  Support  Card  to  interrupt  the 
Cromemco  processor  at  the  desired  rate  and  also  included  the 
interrupt  service  routine  which  initiated  the  next  conver¬ 
sion  cycle.  In  addition,  the  routines  transferred  the  data 
between  the  Cromemco  memory  and  the  converters  and  between 
the  Cromemco  memory  and  the  Nova.  In  order  to  store  as  much 
speech  data  in  the  Cromemco’s  memory  as  possible,  it  was 
decided  to  reduce  the  sample  rate  to  8  KHz.  This  rate 
allowed  approximately  three  seconds  of  acceptable  quality 
digitized  speech  to  be  contained  in  the  Cromemco's  memory 
before  an  additional  transfer  to  or  from  the  Nova  was 
required.  This  quantity  and  quality  of  data  proved  to  be 
very  acceptable  for  supporting  the  other  theses. 

The  two  programs  written  for  the  Nova  were  called  D2A, 
which  transferred  data  from  the  Nova  to  the  Cromemco  and  A2D 
which  transferred  data  the  other  way.  The  initial  approach 
for  transferring  the  data  was  to  temporarily  buffer  it  in 
the  Cromemco  until  it  could  be  transferred  to  the  Nova. 
Once  the  data  was  in  the  Nova,  it  was  temporarily  buffered 
until  it  could  be  put  on  the  disk.  Since  this  was  to  be 
done  in  real  time,  the  software  was  written  so  that  if  the 
Nova  or  Cromemco  fell  behind  while  passing  data,  the 
transfer  would  be  aborted.  It  was  quickly  established  that 
the  Nova  was  unable  to  keep  up,  so  another  approach  had  to 
be  taken. 
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The  software  was  originally  written  to  store  the  speech 
data  on  the  disk  in  random  files,  since  this  was  the 
quickest  approach.  It  was  rewritten  to  use  contiguous 
files,  but  the  Nova  was  still  unable  to  keep  up.  The  only 
other  change  which  could  be  made  and  still  keep  the  transfer 
in  real  time  was  to  use  the  DCH,  since  the  data  was 
currently  being  transferred  by  programmed  I/O.  Since  there 
was  insufficient  time  available  to  support  this  time 
consuming  development,  another  method  of  transferring  the 
data  had  to  be  derived.  It  was  decided  to  sacrifice  the 
real  time  transfer  capability  and  sample  as  much  data  as  the 
Cromemco's  memory  could  hold  before  transferring  it.  This 
allowed  the  data  transfer  to  take  as  long  as  required 
without  interfering  with  the  sampling  or  regeneration 
process  in  the  Cromemco.  Approaching  the  problem  in  this 
manner  greatly  ■  simpl if ied  the  software  required  for  the 
Nova,  further  reducing  the  time  required  to  get  the  system 
operational.  The  main  programs  in  the  Nova  were  written  in 
Fortran;  however,  the  software  to  accomplish  the  actual 
transfer  between  the  two  systems  was  written  in  assembly 
language  and  called  from  the  Fortran  program. 

The  ideal  way  for  the  Nova  to  communicate  with  the 
Cromemco  is  through  a  modification  to  the  Nova  operating 
system.  Such  a  modification  would  make  the  Nova  aware  of 
the  special  device  requirements  of  the  Cromemco,  but  to 
accomplish  this  modification,  the  appropriate  drivers  would 
have  to  be  written  in  the  Nova  assembly  language  and 
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properly  linked  to  the  I/O  portion  of  the  operating  system. 
The  advantage  provided  by  a  modification  of  this  type  is  the 
ability  of  Nova  programs  to  communicate  directly  with  the 
Cromemco  without  the  need  of  an  intermediate  interfacing 
subroutine.  Unfortunately,  it  was  found  to  be  very 
difficult  to  make  this  type  of  modification  to  the  Nova 
operating  system  since  it  has  very  little  documentation  on 
its  actual  internal  structure  and  time  constraints  were  a 
significant  factor.  Therefore,  intermediate  Nova  assembly 
language  routines  were  exclusively  chosen  to  provide  the 
actual  data  communication  capability  with  the  Cromemco. 

While  the  first  stage  of  software  development  provided 
considerable  insight  into  the  limitations  and  capabilities 
of  the  hardware  and  software  of  both  systems,  the  second 
stage  involved  creation  of  the  actual  I/O  CHannel  Operating 
System  (CHOPS)  (see  Appendix  C).  The  CHOPS  enables  the 
Cromemco  to  function  as  a  programmable  I/O  channel  for  the 
Nova.  Although  the  CHOPS  resides  in  the  Cromemco,  it  oper¬ 
ates  in  conjunction  with  a  special  Fortran  subroutine  called 
CHANNEL  that  resides  in  the  Nova  (see  Appendix  D).  CHANNEL 
has  the  responsibility  of  insuring  that  Nova  programs  using 
the  I/O  channel  observe  the  communication  protocol  between 
the  two  systems  and  allows  the  Nova  to  invoke  tasks  in  the 
Cromemco.  To  insure  that  the  CHOPS,  CHANNEL  and  their 
communication  protocol  have  no  adverse  effect  upon  the 
normal  capabilities  of  either  system,  the  constraints  of  the 
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hardware  and  software  of  both  systems  played  a  major  role  in 
their  creation.  The  I/O  Channel  communication  protocol, 
outlined  in  Appendix  E,  was  created  specifically  for  imple¬ 
menting  the  required  I/O  channel  capability;  therefore,  its 
format  and  structure  may  only  apply  to  this  application. 

For  the  I/O  channel  to  operate  in  the  required  manner, 
it  was  necessary  for  the  Crome mco  to  become  an  intelligent 
device  for  the  Nova.  To  provide  this  intelligence, 
Cromemco  software  tasks  which  support  the  data  and  process¬ 
ing  requirements  of  the  Nova  had  to  be  generated.  However, 
the  Cromemco  must  also  appear  as  a  normal  device  to  the 
Nova.  In  order  to  accomplish  this,  an  I/O  channel  communi¬ 
cation  protocol  was  established  to  provide  a  standardized 
method  for  the  Nova  and  Cromemco  systems  to  communicate. 
Under  this  protocol,  the  Nova  CHANNEL  subroutine  sends  com¬ 
mands  and  command  parameters  to  the  Cromemco.  The  Cromemco 
acts  on  these  commands  by  invoking  the  required  tasks  and 
transferring  data  to  and  from  the  Nova. 

CHANNEL  is  a  compact  Fortran  subroutine  with  several 
assembly  language  drivers  that  must  be  called  from  a 
Fortran  main  program.  The  main  program  passes  the  data 
direction,  the  command  mode,  the  parameter  count,  and  the 
task  identification  as  calling  arguments  to  the  subroutine 
which  uses  them  to  form  the  Cromemco  command.  When  data 
and/or  task  parameters  are  to  be  sent  to  the  Cromemco,  they 
are  passed  in  their  respective  arrays.  All  data  received 


from  the  Cromemco  is  returned  in  the  data  array.  If  a  DCH 
is  involved,  the  file  specified  by  the  calling  program  is 
used  to  transfer  the  data.  The  name  of  this  file  must  be 
passed  to  CHANNEL  in  a  character  array.  The  subroutine 
properly  formats  and  formulates  the  information  that  it  is 
passed,  and  then  begins  to  communicate  with  the  Cromemco 
under  the  established  protocol.  All  errors  it  detects, 
including  those  identified  by  the  Cromemco,  are  returned,  as 
an  argument,  to  the  calling  program  by  the  subroutine. 
CHANNEL  implements  the  full  requirements  of  the  protocol; 
therefore,  it  allows  the  addition  of  new  tasks  via  Cromemco 
software  or  hardware  changes,  without  requiring  changes  to 
itself. 

The  CHOPS  was  written  entirely  in  the  Z-80  assembly 
language,  and  was  designed  and  developed  for  the  Cromemco  to 
implement  the  required  I/O  channel  protocol.  Under  this 
protocol,  CHOPS  receives  commands  and  parameters,  validates 
this  information,  then  accomplishes  the  commanded  task. 
Command  words  can  be  accompanied  by  as  many  as  sixteen 
parameter  words.  Parameter  words  allow  such  things  as  data 
block  size,  channel  number,  frequency,  duration,  speed, 
scale  factor,  or  any  other  special  data  that  a  task  may 
require.  One  of  four  modes  is  always  associated  with  each 
command.  Two  of  these  modes  involve  data  transfers.  One  of 
these  two  indicates  a  transfer  by  programmed  I/O  while  the 
other  indicates  a  transfer  using  the  DCH.  A  bit  in  the 
command  word  indicates  the  direction  that  data  is  to  be 


transferred.  One  of  the  two  remaining  modes  is  used  to 
indicate  that  no  data  is  to  be  transferred,  while  the  other 
indicates  that  an  active  command  should  be  aborted  or 
cancelled.  The  command  abort  mode  is  always  associated  with 
a  specific  command.  This  allows  the  Nova  to  cancel  active 
commands  and  is  very  important  if  a  multi-tasking  capability 
were  to  be  added  to  the  CHOPS  in  the  future.  These  command 
modes  allow  the  Nova  to  set  up  for  a  data  transfer  without 
being  concerned  with  the  command  itself.  The  foremost 
advantage  of  the  CHOPS  and  the  channel  protocol  is  that  new 
commands  can  be  added  to  the  system  without  the  necessity  of 
changing  the  Nova's  software. 

There  are  three  types  of  16-bit  words  that  are  defined 
by  the  CHOPS  protocol  (see  Figure  1).  Two  of  these  words, 
the  command  word  and  the  parameter  word,  are  used  to  control 
the  Cromemco  system's  operation.  Under  the  current 
configuration,  these  two  types  of  words  can  only  be 
originated  by  the  Nova  and  are  sent  to  the  Cromemco  to  cause 
it  to  begin  the  execution  of  a  particular  task.  The  third 
type  of  word  defined  by  the  protocol  is  the  data  word. 


The  command  word  is  composed  of  six  fields.  These 
fields,  beginning  at  the  most  significant  bit  and  moving 
toward  the  least  significant  bit  of  a  16-bit  word,  are 
identified  as  the  Command/Parameter  (C/P),  Task  Identifica¬ 
tion  (TID),  Direction/Error  (D/E),  Command  Status  (CS), 
Command  Mode  (CM),  and  Parameter  Count/Error  Code  (P/E) 
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COMMAND  WORD 


1  2 

3  4  5 

6 

7 

8 

9 

10  11 

12  13  14  15 

TASK  ID 

D/E 

CS 

MODE 

P/E 

Bit  0  r  Command/Parameter  ID  Field  (C/P) 
1  =  Command  word 
0  =  Parameter  word 


Bits  1-7  =  TASK  ID  Field  (TID) 

Bit  8  =  Direction/Error  Field  (D/E) 

-  if  in  original  command  from  Nova 

1  =  Cromemco  to  input  from  Nova  or 
output  to  peripheral 
0  =  Cromemco  to  output  to  Nova  or 
input  from  peripheral 

-  if  in  echoed  command  from  Cromemco 

1  =  Error  code  in  P/E  field 
0  =  No  error  occurred 


Bit  9  =  Command  Status  Field  (CS) 

1  =  Command  complete 
0  =  Command  in  progress 

Bits  10-11  =  Command  Mode  Field  (CM) 

00  =  Non  data  transfer 

01  =  Programmed  I/O  data  transfer 

10  =  DCH  block  data  transfer 

11  =  Abort  task 


Bits  12-15 


Parameter  Count/Error  Code  Field  (P/E) 


PARAMETER  WORD 


0 

1  2 

3 

4 

5 

6  7  8  9  10  11  12  13  14  15 

C/P 

PARAMETER  VALUE 

Bit  0  =  Command/Parameter  ID  Field  (C/P) 
1  =  Command  word 
0  =  Parameter  word 


Bits  1-15 


Parameter  Value 


DATA  WORD 


0 

1  2  3 

4  5 

6  7 
DATA 

8  9  10  11  12  13  14  15 

VALUE 

Bits  0-15 

=  Data 

value 

Figure  1.  I/O  Channel  Communication  Words 
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fields.  The  C/P  field  is  composed  of  one  bit  which  is  used 
to  identify  command  words  from  parameter  words.  This  bit 
will  always  be  set  for  a  command  word.  The  TID  field  is  a 
7-bit  field  that  uniquely  identifies  each  task.  The  D/E 
field  is  another  one-bit  field  and  is  used  by  the  Nova  to 
tell  the  Cromemco  which  direction  the  data  associated  with  a 
command,  if  any,  is  to  be  transferred.  When  this  bit  is 
set,  data  will  be  transferred  from  the  Nova  to  the  Cromemco. 
When  it  is  cleared,  data  will  be  transferred  from  the 
Cromemco  to  the  Nova.  The  Cromemco  always  echos  commands 
received  from  the  Nova.  If  this  bit  is  set  in  an  echoed 
command  word,  it  indicates  that  an  error  has  occurred  in  the 
Cromemco.  The  Nova  can  then  extract  the  code  for  this  error 
from  the  P/E  field  of  the  command  word,  "OR"  it  with  its  own 
error  code,  and  return  this  composite  error  to  the  calling 
program.  The  CS  field  is  also  a  one-bit  field  that 
indicates  the  status  of  a  command.  This  bit  is  set  by  the 
Cromemco  only  at  the  completion  of  a  command  and  serves  as  a 
flag  to  the  Nova  to  indicate  that  this  is  the  last  response 
that  the  Cromemco  will  send  with  respect  to  this  command. 
All  responses  from  the  Cromemco  with  this  bit  cleared 
indicate  that  the  command  is  still  in  progress.  The  CM 
field  is  an  encoded  field  composed  of  two  bits.  This  field 
tells  the  Cromemco  the  mode  of  the  command  that  the  Nova  is 
invoking.  These  two  bits  are  encoded  to  represent  four 
different  modes.  The  bit  pattern  "00"  indicates  a  command 
that  requires  no  data  to  be  transferred.  A  "01"  pattern 
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indicates  that  data  associated  with  this  command  will  be 
transferred  using  the  programmed  I/O  capability  of  the 
interface.  A  pattern  of  "10"  indicates  that  the  commanded 
data  will  be  transferred  using  the  DMA/DCH  capability  of  the 
interface.  A  pattern  of  •'ll"  indicates  that  the  Nova  wants 
the  Cromemco  to  abort  the  command  represented  in  the  TID 
field.  The  last  field  of  the  command  is  the  4-bit  P/E 
field.  When  a  command  is  sent  from  the  Nova,  this  field 
contains  the  parameter  count  for  the  number  of  parameter 
words  that  will  follow  this  command.  Since  this  field  is 
comprised  of  only  four  bits  and  a  count  of  zero  has  been 
assigned  to  indicate  that  no  parameters  will  follow  the 
command,  the  maximum  parameter  count  it  can  contain  is 
fifteen.  However,  mode  "01"  (programmed  data  I/O)  or  mode 
"10"  ( DCH  data  I/O)  commands  must  have  a  data  count  or  block 
size,  respectively,  associated  with  them.  This  means  that 
these  two  modes  can  have  as  many  as  sixteen  parameters  even 
though  the  P/E  field  only  allows  fifteen.  The  extra 
parameter  will  always  immediately  follow  the  command  word. 
The  P/E  field  may  also  be  loaded  with  an  error  code  by  the 
Cromemco.  When  the  Cromemco  places  an  error  code  in  this 
field,  it  sets  the  bit  of  the  D/E  field  to  indicate  to  the 
Nova  that  an  error  has  occurred. 

The  parameter  word  is  comprised  of  two  fields.  The 
most  significant  bit  is  the  C/P  field,  which  is  always  a 
zero  for  parameter  words.  The  remaining  fifteen  bits  make 
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up  the  Parameter  Data  (PD)  field  and  are  used  for 
transferring  the  additional  information  that  may  be  required 
by  the  Cromemco  to  properly  process  the  command. 

The  data  word  is  used  to  transfer  the  actual  collected 
or  processed  data  between  the  systems.  The  data  word  is 
allowed  to  be  a  full  16-bit  word  so  that  the  Cromemco  could, 
if  necessary,  accomplish  pre-  or  post-scaling  of  any  of  the 
data  that  it  handles.  This  feature  can  relieve  the  Nova 
from  having  to  reconstruct  or  format  data  of  smaller  word 
sizes  than  it  uses  in  its  normal  operations. 

Under  this  protocol  the  Cromemco  is  required  to 
handshake  with  the  Nova  when  command,  parameter,  or  data 
words  are  transferred  using  programmed  I/O.  This  require¬ 
ment  allows  the  Nova  to  remain  in  complete  control  o.f  the 
Cromemco,  since  it  can  monitor  the  result  of  each  trans¬ 
action,  and  intercede  with  a  new  command  if  errors  are 
detected.  The  handshake  is  accomplished  by  the  Cromemco 
echoing  the  command  word  that  caused  the  transaction  to  take 
place.  By  monitoring  the  D/E,  CS,  and  P/E  fields  of  the 
echoed  command,  the  Nova  can  determine  the  status  of  the 
last  transaction.  One  further  requirement  placed  on  the 
Cromemco  during  parameter  transfers  is  to  decrement  the  P/E 
field  after  each  parameter  is  received.  The  only  exception 
is  that  the  Cromemco  does  not  decrement  the  P/E  fields  after 
the  data  word/block  size  is  transferred  during  mode  ”01"  or 
"10"  commands. 
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The  way  in  which  the  Cromemco  handles  a  command' 
primarily  depends  upon  the  command  itself.  However,  in 
order  to  begin  the  actual  process  or  task  that  the  command 
is  requesting,  there  are  protocol  requirements  that  it  must 
observe.  These  particular  requirements  depend  mainly  upon 
the  mode  of  the  command,  whether  parameters  are  to  be  sent 
with  the  command,  and  the  direction  that  data,  if  any,  is 
flowing.  The  channel  protocol  requires  that  the  command 
sequence  begin  by  the  Nova  placing  a  command  word  in  its  C 
Port  output  register  and  setting  its  BUSY  flag.  Upon 
detecting  the  set  BUSY  flag,  the  Cromemco  reads  the  Nova's  C 
Port  output  register,  checks  the  command  for  validity, 
insures  that  the  CS  bit  of  the  command  word  is  cleared,  and 
echos  the  command  by  writing  it  into  the  Nova's  C  Port  input 
register  which  completes  the  handshake  for  the  command  word 
transfer . 

For  a  mode  "00"  command  without  parameters,  the 
Cromemco  will  begin  executing  the  commanded  task  immediately 
after  the  command  word  has  been  echoed  to  the  Nova.  If 
parameters  were  included  with  the  command,  the  Cromemco 
would  collect  and  validate  the  parameters  before  attempting 
to  execute  the  command.  The  Nova  must  clear  the  DONE  flag, 
which  is  set  as  a  result  of  each  echo.  This  will  allow  the 
Cromemco  to  echo  the  original  command  with  the  D/E  and  CS 
bits  set  when  an  intermediate  error  is  detected  during  the 
command  execution.  Since  the  Cromemco  waits  for  the  DONE 
flag  that  was  set  by  a  previous  echo  to  clear  before 
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transmitting  again,  the  channel  could  become  hung  if  the 
Nova  does  not  clear  the  DONE  flag  after  each  echo  reception. 
The  P/E  field  will  also  contain  a  unique  error  code 
identifying  the  error.  Normally,  as  a  result  of  an  error, 
the  Cromemco  will  completely  abort  the  commanded  task, 
return  to  its  command  collection  mode  and  must  be  re¬ 
commanded  to  again  invoke  this  task.  Hopefully,  as  more 
elaborate  tasking  software  with  built-in  error  correction 
schemes  evolves,  this  can  become  the  exception  rather  than 
the  rule.  When  a  commanded  task  completes  the  original 
command  without  an  error,  the  D/E  bit  will  be  cleared  and  CS 
bit  will  be  set  in  the  original  command  word,  then  it  is 
echoed  to  the  Nova.  The  Cromemco  then  returns  to  its 
command  collection  mode  to  await  the  next  command. 

When  a  mode  "01"  or  "10"  command  is  received,  the 
Cromemco  must  insure  that  it  first  collects  the  extra  word 
count/block  size  parameter  and  then  any  other  parameters 
that  are  indicated  by  the  count  contained  in  the  command 
word  P/E  field.  It  is  the  responsibility  of  the  commanded 
task  to  accomplish  the  actual  data  transfer.  These  tasks 
can  call  CHOPS  routines  which  have  been  designed 
specifically  for  this  purpose.  Utilization  of  these 
routines  insures  that  the  I/O  channel  protocol  is  observed. 
However,  special  high  data  rate  applications  may  require 
these  tasks  to  provide  their  own  specialized  data  transfer 
routines  compatible  to  both  the  tasks  requirements  and  the 
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channel  protocol.  Data  transfer  is  accomplished  via  the 
programmed  I/O  or  the  DCH  capabilities.  During  a  mode  "01", 
programmed  I/O  data  transfer,  the  Nova  sends  the  Cromemco  a 
special  data  command,  which  has  been  assigned  a  TID  of  $7F, 
to  indicate  that  the  next  word  will  be  data.  The  Cromemco 
must  validate  the  command,  and  echo  it  with  the  D/E  and  CS 
bits  cleared.  It  must  then  transfer  the  data  and  again  echo 
the  data  command,  if  an  error  was  not  detected,  with  its  D/E 
bit  cleared  and  its  CS  bit  set.  If  either  the  Data  Command 
or  the  data  word  following  it  is  in  error,  the  D/E  and  CS 
bits  will  both  be  set  and  the  respective  error  code  will  be 
placed  in  the  P/E  field  of  the  echoed  Data  Command.  This 
Data  Command  from  the  Nova,  Data  Command  echo  from  the 
Cromemco,  data  word  transfer,  and  Data  Command  echo  from  the 
Cromemco  sequence  is  repeated  for  each  data  word  that  is 
transferred.  After  all  the  data  has  been  transferred  and 
all  other  processes  imposed  by  the  command  have  been 
completed,  the  Cromemco  will  echo  the  original  command  with 
the  CS  bit  set  and  return  to  its  command  collection  mode. 

For  a  mode  "10"  DCH  transfer,  the  block  size  is 
received  as  the  extra  parameter.  This  block  size  is  in 
increments  of  256  words  and  is  used  to  indicate  the  number 
of  data  words  that  the  Cromemco  is  to  transfer  before  send¬ 
ing  the  Data  Command  to  request  the  next  block.  For  each 
block  transfer,  the  Nova  indicates  that  the  block  buffer  is 
ready  by  clearing  the  DONE  flag  w  ithout  setting  BUSY.  The 
Cromemco  then  continues  the  transfer,  block  by  block,  until 


the  Nova  places  the  Data  Command  with  the  CS  bit  set  in  its 
C  Port  and  sets  the  BUSY  flag.  The  Cromemco  validates  this 
Data  Command,  completes  the  remaining  tasks  implied  by  the 
original  command  and  echos  the  original  command  with  the 
appropriate  bits  set  as  in  the  previously  discussed  modes. 
The  Cromemco  can  also  terminate  the  DCH  transfer  by  setting 
the  DONE  flag.  This  is  accomplished  by  loading  the  Nova's  C 
Port  with  a  Data  Command  that  has  its  CS  bit  set. 

The  "11"  mode  allows  the  Nova  to  cancel  or  abort  a  task 
that  is  in  operation.  All  parameter  conventions  and  echo 
hand  shaking,  as  previously  discussed,  still  apply  to  this 
command.  Since  the  Nova  does  not  interrupt  the  Cromemco, 
the  Cromemco  must  be  looking  for  input  from  the  Nova  in 
order  to  receive  it.  This  is  accomplished  during  task 
execution  by  periodically  checking  to  see  if  the  Nova  has 
sent  a  new  command  and  by  testing  all  commanded  requests 
from  the  Nova  for  an  abort.  When  detected,  the  Cromemco 
services  this  command  by  merely  deactivating  the  task  in 
progress  and  echoing  the  abort  command  word  with  its  CS  bit 
set. 

As  can  be  seen,  the  I/O  Channel  is  quite  versatile.  It 
and  its  protocol  have  been  designed  to  support  multi-tasking 
in  the  event  that  the  necessary  additional  software  and 
hardware  to  support  such  a  capability  is  added  to  the  I/O 
channel  in  the  future. 


III.  Design  and 


This  section  examines  the  design  of  the  Nova's  GPI 
board  and  the  interface  board  in  the  Cromemco  system  and  how 
they  work  together.  It  also  describes  the  software 
developed  on  both  the  Nova  and  the  Cromemco  to  implement  the 
initial  speech  I/O  capability  as  well  as  the  data  channel 
which  came  later. 

The  Nova  Interface  Board 

The  GPI  is  built  by  GD  to  provide  an  interface  between 
the  Nova's  I/O  bus  and  the  peripherals.  It  was  used  as  a 
basis  for  the  hardware  on  the  Nova's  side  of  the  data 
channel.  About  two-thirds  of  the  board  is  prewired.  The 
remaining  third,  located  along  the  edge  of  the  board  away 
from  the  backplane,  is  the  breadboard  area.  Two  rows  of 
wire-wrap  pins  separate  the  prewired  area  from  the 
breadboard  area  of  the  board.  These  pins  are  connected  to 
the  various  inputs  and  outputs  of  the  prewired  circuits  that 
are  ma«-  available  to  the  designer.  To  allow  enough 
clearance  for  a  board  to  be  placed  above  the  GPI,  the  wire- 
wrap  pins  are  quite  short.  Therefore,  they  can  only  hold 
about  two  wraps. 

The  GPI  cannot  be  used  as  it  comes  from  the  factory. 
It  must  be  configured  by  the  user  for  his  particular 
application  by  interconnecting  the  wire-wrap  pins.  Although 
this  provides  a  great  deal  of  flexability;  DG  does  not 
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supply  very  specific  information  about  how  to  accomplish 
this.  The  information  used  to  configure  the  board  was 
derived  indirectly  by  examining  DG's  description  of  the  I/O 
bus.  Most  of  this  information  is  contained  in  the  following 
pages.  Before  attempting  to  discuss  the  registers,  it 
should  be  noted  that  the  bit  number  of  the  Nova's  data  bus 
is  reversed  from  the  numbering  used  by  most  computer 
manufacturers.  For  the  Nova,  the  most  significant  bit  is 
denoted  as  DATAO,  while  the  least  significant  bit  is  denoted 
as  DATA15. 

Each  programmed  I/O  instruction  includes  the  six-bit 
device  code  which  designates  the  particular  interface  to  be 
involved  in  the  operation.  During  the  execution  of  the 
instruction,  the  device  select  lines  of  the  I/O  bus,  DSO// 
through  D  S  5  // ,  carry  the  device  code  of  the  desired 
interface.  Note:  a  pound  sign  (#)  on  the  end  of  the  name  of 
a  signal  indicates  that  it  is  active  low.  In  addition  to 
the  device  select  lines  there  are  three  control  lines  on  the 
I/O  bus  (DATIA,  DAUB,  and  DATIC)  which  designate  an  input 
to  Port  A,  B,  or  C,  and  three  lines,  DATOA,  DATOB,  and 
DATOC,  which  designate  an  output  to  Port  A,  B,  or  C.  The 
timing  of  these  signals  is  shown  in  Figure  2.  All  six  of 
the  I/O  signals  are  made  available  to  the  user  through  wire- 
wrap  pins. 
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Figure  2.  Nova  Programmed  I/O  Timing  Diagram 

The  GPI  provides  circuitry  which  can  be  wired  to  decode 
the  device  select  bus  for  any  one  of  the  desired  device  code 
(see  Figure  3).  This  circuitry  is  simply  an  eight  input 
NAND  gate  with  some  inverters.  It  uses  jumpers  to  feed 
either  an  inverted  or  noninverted  signal  from  the  device 
select  bus  to  the  NAND  gate.  The  output  of  the  NAND  gate  is 
buffered  by  two  inverters  to  become  DEVICE  SELECT  1  and  2. 
The  former  is  NANDed  with  each  of  the  six  input/output 
signals  used  by  the  ports  to  generate  an  active  low  signal 
that  can  be  used  to  clock  data  onto  or  off  of  the  Nova's 


data  bus  (see 

Figure  3). 
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signal  that  allows  the  Nova  to  communicate  with  the  input 
and  output  registers  of  a  device. 


The  input  and  output  registers  used  for  the  A  Port  in 
this  interface  were  prewired  on  the  GPI  (see  Figure  4). 
They  each  consist  of  four  4-bit  parallel-access  shift 
registers  (SN74195).  Each  register  is  wired  the  same  way 
except  for  the  shift/load  line  and  the  data  inputs  and 
outputs.  The  shift/load  line  of  the  output  register  pro¬ 
vides  for  the  ANDing  of  two  inputs  to  it,  while  the  input 
register  does  not.  The  clock  inputs  of  both  registers  will 
NAND  two  signals.  A  serial  input  and  a  clear  input  are 
also  available  to  the  user.  The  data  inputs  of  the  output 
register  are  connected  to  the  Nova's  data  bus  through  inver¬ 
ters.  The  inverters  both  buffer  the  data  bus  and  transform 
the  data  from  active  low  to  active  high.  Unfortunately,  the 
data  outputs  of  this  register  are  also  buffered  through 
inverters  resulting  in  complimentary  data.  The  inputs  of 
the  input  register  are  connected  to  wire-wrap  pins  which  are 
connected  to  the  16-bit  input  data  path  of  the  interface 
cable.  The  outputs  of  the  register  are  gated  on  to  the 
Nova's  data  bus  through  open  collector  NAND  (SN7438)  gates 
(see  Figure  3).  This  both  buffers  and  compliments  the 
register's  output  as  required  by  the  bus.  The  registers 
were  assigned  to  the  A  Port  by  tying  DATA  OUT  A#  (pin  18  on 
the  GPI)  to  the  input  register's  clock  (pin  33)  and  by  tying 
DATA  IN  A#  (pin  41A)  to  one  side  of  the  gates  on  the  outputs 
of  the  output  register.  Pin  17  and  pin  32  of  both  registers 
are  t^ed  low  to  place  them  in  the  parallel  load  mode. 
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The  prewired  register  on  the  GPI  designed  to  be  used  as 
an  address  register  for  DCH  transfer  was  assigned  to  Port  B 
(see  Figure  4).  This  register  consists  of  four  4-bit  binary 
counters  (SN74177)  which  are  configured  to  increment  from 
0000  to  FFFF  (Hex)  when  CL1  of  the  counter  is  clocked.  The 
counters  can  be  parallel  loaded  so  the  register  can  be 
written  to  by  the  Nova  processor.  The  outputs  of  this 
register  are  connected  to  the  data  bus  through  open 
collector  NAND  gates  and  the  inputs  are  connected  to  the  bus 
through  inverters  the  same  way  as  the  A  Port  registers.  The 
CA  CLOCK  (connected  to  CL1),  CA  DATA  (DATA  STROBE  of  the 
counter),  and  the  NAND  gates  on  the  outputs  all  allow  the 
user  to  OR  two  signals  together  before  supplying  them  to  the 
register.  The  user  is  also  given  access  to  the  reset  line 
of  the  counter  through  a  single  input.  Wire-wrap  pins  are 
connected  to  the  output  of  this  register  but  the  inputs  are 
not  made  available.  The  register  is  assigned  to  the  B  Port 
by  tying  DATA  IN  B //  (pin  43A)  to  one  input  of  the  NAND  gates 
(pin  108)  and  connecting  DATA  OUT  Bit  (pin  14A)  to  CA  DATA 
(pin  60).  The  required  connections  for  the  DCH  will  be 
discussed  later  in  this  section. 

The  last  prewired  register  to  be  discussed  is  the  word- 
count  register.  This  register  is  used  simply  as  an  output 
register  for  the  C  Port  since  the  Cromemco  will  track  the 
word  count  internally.  This  register  consists  of  four 
SN74177's  configured  the  same  way  as  the  address  register 
(see  Figure  5).  The  main  difference  between  the  two  is 


that  the  outputs  of  the  word  count  register  are  connected 
through  inverters  to  wire-wrap  pins.  An  output  register  for 
the  C  Port  had  to  be  built  since  there  were  no  additional 
prewired  registers  on  the  GPI.  The  new  output  register  had 
to  have  access  to  the  Nova's  data  bus  which,  unfortunately, 
is  not  provided  anywhere  on  the  GPI.  Therefore,  an  output 
buffer  of  NAND  gates  using  four  SN7438s  was  built  in  the 
breadboard  area  of  the  GPI  and  its  outputs  were  wired  to  the 
circuit  traces  in  the  prewired  section  of  the  board  which 
would  connect  it  to  the  data  bus.  Four  shift  registers 
(SN74195)  were  added  to  the  GPI  to  form  the  rest  of  the 
output  register.  All  the  inputs  on  one  side  of  the  NAND 
gates  were  tied  together  and  connected  through  a  buffer  to 
DATA  IN  C#  (pin  44).  This  assigned  the  new  output  register 
to  the  C  Port. 

In  order  to  complete  the  description  of  the  programmed 
I/O  section  of  the  board,  the  BUSY/DONE  network  must  be 
discussed  (see  Figure  5).  The  BUSY/DONE  network  uses  two 
flip-flops  (SN7474)  to  provide  the  BUSY  and  DONE  flags.  The 
output  of  these  flip-flops  are  connected  to  wire-wrap  pins 
for  user  access  and  NANDed  with  DEVICE  SELECT  2,  generating 
the  signals  SELD#  and  SELB#.  SELD#  and  SELB#  are  placed  on 
the  I/O  bus  when  the  device  is  selected  so  the  processor  can 
read  the  flags.  The  rest  of  the  BUSY/DONE  network  provides 
the  logic  to  perform  the  following  functions: 

1.  Clear  both  flags  when  the  I/O  RESET#  or  CLEAR# 
signals  are  generated. 
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2.  Set  the  BUSY  flag  and  clear  the  DONE  when 
the  START//  signal  is  generated. 

3.  Clear  the  BUSY  flag  and  set  the  DONE  on  the 
positive  transition  of  a  clock  applied  to  pin  56 
(DEVICE  ACKNOWLEDGE).  DEVICE  ACKNOWLEDGE  has  no 
effect  if  the  BUSY  is  not  set. 

There  are  times  that  the  I/O  Channel  protocol  requires 
the  Cromemco  to  set  the  DONE  flag  when  the  BUSY  flag  is  not 
set;  therefore,  the  BUSY/DONE  network  had  to  be  modified. 
This  was  accomplished  by  lifting  pin  12  of  U22  (DONE  flip- 
flop)  from  its  printed  circuit  board  connection  and 
connecting  it  to  +5  volts  through  a  3  k-ohm  resistor.  This 
modification  allows  the  DONE  flip-flop  to  be  set  each  time 
DEVICE  ACKNOWLEDGE  is  clocked.  The  clearing  of  the  flag  is 
not  affected  since  CLEAR//  uses  the  reset  input  of  the  flip- 
flop.  The  interrupt  control  logic  is  also  associated  with 
the  BUSY/DONE  network.  Since  interrupts  were  not 
implemented,  they  were  disabled  by  tying  the  D  input  of  the 
INTERRUPT  DISABLE  flip-flop,  (pin  86)  low. 

Now  the  means  of  high  speed,  bulk  transfer  of  data,  the 
DCH,  will  be  discussed.  Since  more  functions  must  be  per¬ 
formed  for  each  DCH  transfer,  the  interplay  between  the 
Nova’s  processor  and  the  interface  is  more  complex  than  that 
involved  in  programmed  I/O.  An  interface  requests  a  data 
channel  by  asserting  the  DCHR//  line  of  the  I/O  bus.  When 
the  processor  checks  this  line  and  finds  it  asserted,  a  DCH 
is  executed.  No  software  is  required  to  perform  the  DCH 
itself;  however,  normal  program  execution  is  suspended 


during  the  transfer.  This  delay  is  not  usually  noticable 
since  the  transfer  takes  place  in  one  to  two  microseconds. 
The  signal  RQENB#  is  used  to  sync  DCHR#  to  the  I/O  bus  (see 
Figure  6).  The  GPI  uses  the  leading  edge  of  REQENB#  to 
clock  DCHR#  on  to  the  bus.  The  processor  issues  the  DCH 
acknowledge  signal,  DOHA#  in  response  to  the  DCHR  as  the 
first  step  in  a  DCH  transfer.  This  signal  goes  to  all 
interfaces  on  the  I/O  bus  with  the  processor  expecting  the 
memory  address  and  mode  of  the  transfer  in  response.  A 
priority  network  rather  than  the  device  select  bus  is  used 
to  determine  which  interface  is  to  respond  to  these  signals. 
This  priority  network  is  accomplished  by  daisy  chaining  the 
interfaces  with  a  signal  which  is  called  DCHP  IN#  as  it 
enters  and  DCHP  OUT#  as  it  leaves.  Under  this  system  the 
interface,  which  is  physically  closer  to  the  procesor  on  the 
priority  chain,  receives  the  highest  priority.  Normally 
each  interface  passes  the  DCHP#  signal  undisturbed  on  to  the 
next  interface;  however,  when  this  signal  reaches  the 
requesting  interface,  it  is  trapped  so  it  does  not  pass  to 
next  interface  (see  Figure  7).  A  device  is  "selected"  when 
it  receives  the  DCHP  IN  signal  in  response  to  a  DCH  request. 

Before  one  DCH  cycle  is  complete,  the  DCH  request  from 
the  interface  being  serviced  must  be  cleared  in  order  to 
prevent  an  immediate  second  transfer.  Therefore  the  DCH  SEL 
flip-flop  (see  Figure  7)  is  used  to  indicate  that  a  DCH 
transfer  is  occurring  for  the  interface.  The  DCH  SEL  flag 
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is  set  at  the  beginning  of  a  DCH  transfer  for  the  interface 
and  cleared  at  the  beginning  of  the  next.  The  DCH  SEL  is 
only  set  when  DCHP  is  present.  The  DCH  SEL  flag  serves  the 
same  purpose  that  DEV  SEL  does  in  parallel  I/O.  It 
indicates  when  the  interface  should  respond  to  a  transfer. 

While  receiving  DCHA#,  the  interface  with  its  DCH  SEL 
flag  set  places  the  address  contained  in  the  address 
register  (B  Port)  on  the  data  bus.  This  is  done  on  the  GPI 
by  NANDing  DCHA,  DCHP  IN,  the  DCH  REQ  flag,  and  the  DCH  SEL 
flag  (see  Figure  7).  The  resultant  signal  is  called  ADD 
ENABLE#.  This  signal  is  also  used  to  clear  the  DCH  SYNC 
flag  which  then  causes  the  DCH  REQ  flag  to  be  cleared  on  the 
next  REQENB.  A  DCH  has  four  possible  modes  which  are 
selected  by  asserting  DCHMO#  and  DCHM1#  on  the  I/O  bus.  The 
codes  of  the  modes  and  their  functions  are  "00"  for  Output, 
"01"  for  Increment,  "10"  for  Input,  and  "11"  for  Add  to 
Memory.  DCHMO#  serves  as  the  most  significant  bit  and 
DCHM1#  the  least  significant  bit  of  this  code.  Input  and 
Output  are  with  respect  to  the  Nova  processor  and  are  self 
explanatory;  however,  Increment  and  Add  to  Memory  need  some 
explanation.  Add  to  Memory  causes  a  data  word  that  is 
transferred  from  the  interface  to  be  added  to  the  contents 
of  the  memory  location  supplied  by  the  interface.  The 
result  of  this  addition  is  deposited  into  the  memory  loca¬ 
tion  and  also  transferred  back  to  the  interface  with  a  DCH 
out.  The  0VFL0  signal  on  the  bus  will  be  pulsed  if  this  sum 
is  greater  than  2^6-1,  Increment  is  similar  to  Output; 
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except,  the  contents  of  memory  are  incremented  before  being 
sent  to  the  interface.  The  same  value  that  is  sent  to  the 
interface  is  also  deposited  into  the  memory  location. 

DCHI#  and  DCHOff  are  the  I/O  bus  signals  which  indicate 
when  the  data  should  be  placed  onto  or  clocked  off  of  the 
data  bus,  respectively.  These  signals  are  inverted  and 
NANDed  with  DCH  SEL  by  the  Data  Channel  Control  circuits  to 
form  DCH  SEL*DCHI#  (pin  58)  and  DCH  SEL*DCHO#  (pin  59A).  To 
assign  the  A  Port  to  the  DCH,  DCH  SEL*DCHI#  is  connected  to 
pin  106  of  the  input  register  (see  Figure  4).  The  outputs 
of  the  register  are  gated  onto  the  data  bus  on  the  low 
transition  of  this  signal.  In  addition,  DCH  SEL*DCH0#  is 
connected  to  pin  32A  of  the  A  Port  output  register  (see 
Figure  4).  The  contents  of  the  data  bus  are  clocked  into 
the  register  on  the  low  transition  of  this  signal. 

The  remaining  circuits  on  the  GPI  were  installed  to 
multiplex  the  output  registers  onto  the  interface  cable  (see 
Figure  8).  This  was  done  with  tri-state  bus  drivers. 
Inverting  drivers  (SN74240)  were  used  for  the  prewired 
registers  since  their  outputs  are  inverted  by  the  GPI  and 
noninverting  drivers  (SN74244)  were  used  for  the  added 
register,  C  Port.  One  of  three  control  lines  (A  SEL,  B  SEL, 
or  C  SEL)  is  used  to  select  the  desired  output  register. 
Each  control  line  is  connected,  through  a  buffer,  to  the 
enable  lines  of  the  drivers  for  its  respective  register. 
These  control  lines  are  also  used  to  select  which  register 
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is  to  be  loaded  by  the  I/O  Channel.  A  clock  from  the  I/O 
Channel  is  directed  to  the  appropriate  register  by  its 
respective  select  signal.  As  indicated  earlier,  the  B  Port 
cannot  be  loaded  and  therefore  is  not  clocked  by  the  I/O 
Channel.  However,  a  set  of  input  and  output  registers  could 
be  put  in  the  breadboard  area  which  could  function  as  both 
the  address  register  during  a  DCH  and  normal  input  or  output 
registers  during  programmed  I/O. 

Nova  Software 

The  Nova  software  includes  a  Fortran  subroutine  called 
CHANNEL,  and  four  Fortran  callable  assembly  language 
subroutines,  SANDS,  CANDR,  DCHTX,  and  DCHRX  (see  Appendix 
D).  SANDS  and  CANDR  communicate  with  the  I/O  Channel 
through  the  C  Port  while  DCHTX  and  DCHRX  handle  any  DCH 
transfers.  As  indicated  earlier  CHANNEL  is  designed  to 
allow  the  addition  of  tasks  to  CHOPS  without  requiring 
changes  to  itself.  It  simply  passes  the  number  of  the 
desired  task  on  to  CHOPS  without  decoding  it.  CHANNEL  can 
still  perform  all  the  required  data  transfers  by  decoding  at 
the  direction  and  mode  fields. 

The  task,  direction  of  transfer,  parameter  count,  and 
mode  are  some  of  the  nine  arguments  passed  by  the  calling 
routine  to  CHANNEL.  They  are  first  combined  into  a  command 
word  and  then  sent  to  the  I/O  Channel  by  CHANNEL.  Each 
argument  is  checked  to  insure  that  it  falls  within  the 
appropriate  bounds.  If  the  transfer  is  mode  one,  a  data 


count  indicating  the  number  of  data  words  involved  must  also 
be  passed.  If  the  transfer  is  a  mode  two  type,  a  block 
count  must  be  passed.  This  block  count  is  the  number  of 
Nova  disk  blocks  (256  words  each)  which  will  be  transferred 
at  one  time  during  a  DCH.  In  other  words  this  is  the  number 
of  disk  blocks  which  are  collected  in  a  buffer  before  being 
transferred  by  DCH.  In  addition,  if  the  transfer  is  from 
the  I/O  Channel  to  the  Nova  and  the  user  requires 
contiguous  file  to  be  created,  the  total  number  of  blocks  to 
be  transferred  must  be  passed.  If  a  random  file  is  required 
instead,  a  zero  should  be  passed  in  this  field.  The  name  of 
the  file  which  will  serve  as  a  source  or  destination  of  the 
data  in  a  DCH  transfer  is  passed  in  a  character  array.  In 
addition,  any  parameters  or  data  required  for  mode  one  are 
passed  in  PARRAY  and  DARRAY,  respectively. 

CHANNEL  also  provides  considerable  error  detection  (see 
Appendix  F).  Any  error  that  is  detected  is  returned  as  an 
argument  to  the  main  program.  Since  the  I/O  Channel  can 
return  errors  of  its  own,  in  addition  to  the  errors  which 
occur  within  CHANNEL  itself,  the  error  word  includes  two 
fields.  The  most  significant  byte  contains  CHANNEL  errors 
while  the  least  significant  byte  contains  errors  returned  by 
the  I/O  Channel.  If  an  error  occurs  during  the  transfer  of 
a  parameter,  PCOUNT  will  return  with  the  number  of  the 
parameter  being  passed  at  that  time.  This  also  happens  when 
data  is  transferred,  except  the  number  is  returned  in 
DCOUNT.  If  a  Nova  error  occurs  after  a  command  has  been 
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sent  to  the  I/O  Channel,  CHANNEL  will  automatically  transmit 
an  abort  command  before  returning  to  the  main  program.  This 
insures  that  CHOPS  is  not  left  waiting  for  a  particular 
response  from  the  Nova.  An  abort  is  indicated  by  setting 
the  most  significant  bit  of  CHANNEL'S  error  byte.  If  the 
I/O  Channel  ignores  the  abort  command,  CHANNEL'S  error  byte 
will  be  set  to  all  ones  indicating  the  I/O  Channel  is 
malfunctioning  and  should  be  reset. 

Cromemco  Interface  Hardware 

The  hardware  which  interfaces  the  Cromemco  to  the  Nova 
was  constructed  using  a  Universal  Microcomputer  Processor 
Plugboard  (model  #8800V-A)  manufactured  by  Vector  Electronic 
Company.  This  breadboard  is  designed  specifically  for  the 
S-100  bus  system  and  provides  the  S-100  edge  connector  and 
electrical  traces  for  supplying  power  to  the  circuitry 
placed  on  the  board.  Pads  are  conveniently  provided  for 
installing  up  to  four  of  the  appropriate  voltage  regulators 
required  by  all  S-100  bus  interfaces.  Also,  the  board  is 
pre-drilled  with  component  mounting  holes  on  a  one-tenth 
inch  center  pattern  and  provides  an  extensive  ground  plane. 
Wire-wrap  sockets  were  installed  on  the  breadboard  to 
accommodate  all  the  IC's  used  in  this  design.  Although 
wire-wrap  sockets  are  more  expensive,  the  additional  expense 
they  incur  is  small  when  compared  to  the  design  evolution 
advantages  and  the  interface  maintainability  gained  through 
their  use. 
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The  actual  interface  circuit  can  be  divided  into  three 


major  functional  areas.  These  consist  of  the  I/O  port 
decoding  logic,  the  data  path/data  bus  interface  logic,  and 
the  DCH/DMA  support  logic.  The  I/O  port  decoding  logic 
provides  the  necessary  combinational  logic  to  decode  the  I/O 
ports  of  both  the  Cromemco  and  the  Nova  by  supplying  the 
proper  signals  to  the  data  path/data  bus  interface  logic. 
The  data  path/data  bus  interface  logic  consists  of  several 
8-bit  tristate  bus  drivers  and  latches  that  are  used  to  map 
the  8-bit  data  bus  of  the  Cromemco  into  the  16-bit  ports  of 
the  Nova.  This  logic  also  includes  the  circuitry  that 
allows  the  Nova  BUSY  and  DONE  flags  to  be  read  by  Cromemco. 
The  DCH/DMA  support  logic  is  the  part  of  the  interface  that 
accomplishes  the  required  handshaking  with  the  Nova's  DCH 
circuitry.  Provisions  have  been  made  in  this  part  of  the 
interface  to  include  the  necessary  control  logic  for  a 
future  inhancement  to  the  interface  which  will  provide  the 
Cromemco  with  a  DMA  capability. 

The  I/O  port  decoding  logic  derives  its  inputs  from  the 
signals  propagating  on  the  Cromemco/S- 1 00  bus.  These  inputs 
consist  of  the  least  significant  eight  bits  of  the  16-bit 
address  bus  and  the  sINP,  sOUT,  pWR#,  pDBIN,  sXTRQ#,  and, 
SIXTN0  signals.  When  either  the  sINP  or  the  sOUT  signal  is 
present  on  the  bus,  the  output  of  IC3a  (see  Appendix  G) 
becomes  active,  enabling  the  outputs  of  both  of  the  four- 
line  to  sixteen-line  decoders  (SNT^IS^),  IC11  and  IC12. 
I C 1 1  is  connected  to  decode  the  upper  four  bits  of  the  least 
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significant  8-bits  of  the  address  bus.  Its  A,  B,  C,  and  D 
decoded  outputs  become  active  when  an  I/O  port  address  of 
$AX,  $BX,  $CX,  or  $DX,  respectively,  appears  on  the  low  byte 
of  the  address  bus  during  either  an  input  (sINP)  or  output 
(sOUT)  cycle.  Likewise,  IC12,  the  other  decoder,  is 
connected  to  the  lower  four  bits  of  the  address  bus  and  the 
outputs  that  are  used  from  it  become  active  when  an  I/O  port 
address  of  either  $X0,  $ X 1 ,  or  $X2  appears  on  the  bus  during 
the  proper  cycle.  The  decoded  A,  B,  and  C  outputs  from  IC11 
are  combined  by  IC5a  to  generate  a  signal  which  indicates 
that  access  is  required  of  a  Cromemco  I/O  port  having  a 
counterpart  in  the  Nova.  All  of  these  outputs  are  then 
gated  with  the  bus  read  (pDBIN)  and  write  (pWR/f)  signals  by 
IC5b,  IC5c,  IC6a,  IC6b,  and  IC6c  to  generate  the  necessary 
control  signals  to  activate  the  circuitry  of  the  data 
path/data  bus  control  logic.  The  decoders  also  allow  easy 
relocation  of  the  ports  on  the  interface  should  a  conflict 
arise.  This  is  because  each  decoder  provides  sixteen  output 
signals  for  the  four  bits  it  decodes.  Therefore,  port 
relocation  simply  requires  rewiring  to  the  proper  outputs  of 
the  two  decoders. 

The  data  path/data  bus  control  logic  maintains  control 
with  six  8-bit  tristate  non-inverting  bus  drivers  (IC3,  IC7, 
IC8,  IC1H,  IC15,  and  IC17).  These  drivers  are  used  to  gate 
the  least  significant  (IC3  or  IC8  and  IC17)  or  most 
significant  (IC7  and  IC15)  portion  of  a  16-bit  word  to  and 
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from  the  Cromemco  data  bus.  When  ports  $A0-$A1,  $B0-$B1f 
and  $C0-$C1  are  accessed  by  the  Z-80,  the  proper  drivers  are 
activated  to  allow  8-bit  bytes  of  data  to  be  transferred. 
The  circuitry  composed  of  IC2b,  IC2d,  and  ICIOa  allows  the 
interface  to  respond  to  requests  for  16-bit  I/O  transfers. 
This  is  accomplished  by  receiving  the  SIXTN#  signal  from  the 
bus  and  allowing  IC7  and  IC8  to  be  activated  to  form  a 
16-bit  input  path  or  IC15  and  I C 1 7  to  form  a  16-bit  output 
path.  The  SIXTN#  signal  is  actually  a  request  signal; 
therefore,  it  must  be  acknowledged.  This  is  accomplished  by 
generating  the  sXTRQ#  signal  at  the  output  of  IC2b. 
Unfortunately,  the  Z-80  processor  does  not  support  16-bit 
memory  or  I/O  transfers,  but  the  memory  in  this  system  can. 
It  was  therefore  decided  to  generate  an  interface  to  match 
the  memory's  capability  in  the  event  that  the  system  is 
later  upgraded  to  a  16-bit  processor.  One  other  bus  driver, 
IC4,  is  included  to  allow  the  Nova  BUSY  and  DONE  flags  and 
the  other  interface  control  flags  to  be  placed  on  the 
Cromemco  input  data  bus.  It  is  activated  when  port  $D0  is 
read.  Additionally,  I C 1  6  provides  an  8-bit  tristate  latch 
that  is  used  for  holding  the  most  significant  portion  of 
each  16-bit  word  that  is  to  be  transferred  out  of  the 
interface  to  the  Nova. 

A  transfer  from  the  Nova  to  the  Cromemco  takes  place 
when  a  Nova  port  output  register  is  selected  via  the  A 
SELECT,  B  SELECT,  or  C  SELECT  signals  originating  from  IC 11. 
These  signals  also  cause  the  signal  from  ICIOd  to  allow 
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IC7  to  become  active,  which  places  the  most  significant  byte 
of  the  Nova  register  onto  the  Cromemco  input  data  bus. 
Likewise  the  signal  from  IC2d  enables  IC3  to  place  the  least 
significant  byte  of  the  selected  Nova  port  ouput  register 
onto  the  Cromemco  input  data  bus.  For  transferring  data  from 
the  Cromemco  to  the  Nova,  the  most  significant  byte  must  be 
transferred  first.  It  is  latched  by  IC16  when  the  signal 
from  IC6b  is  present.  When  the  higher  address  of  each  port 
pair  ($A1,  $B1,  or  $C1)  is  written  to,  an  output  from  IC6b 
is  generated.  Since  IC17  is  always  enabled,  the  least 
significant  byte  will  be  placed  onto  the  data  path  immed¬ 
iately  when  it  is  written  via  ports  $A0,  $B0,  or  $C0.  Since 
the  data  in  the  latch  is  already  present  on  the  most 
significant  half  of  the  data  path,  the  trailing  edge  (low  to 
high  transition)  of  the  signal  from  IC6a,  DEVICE  COMPLETE#, 
causes  sixteen  bits  of  data  to  be  clocked  into  the  selected 
Nova  register.  To  read  the  status  flags  the  output  of  IC6c 
is  activated  by  inputting  from  port  $D0.  This  causes  IC4  to 
place  a  byte  containing  t^e  I/O  Channel  status  flags, 
including  the  Nova  BUSY  and  DONE  flags,  onto  the  Cromemco 
input  data  bus. 

The  DCH/DMA  support  logic  is  composed  of  IC21b,  IC22a, 
IC25a,  IC25b,  IC26a,  and  IC26b.  These  devices  generate  the 
proper  signals  to  handshake  with  the  Nova's  DCH  control 
circuitry.  The  IC25a  flip-flop  is  clocked  by  the  signal 
from  IC21b,  which  is  generated  by  an  output  to  port  $C2. 
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The  IC25a  Q  output  then  goes  high  and  its  Q//  output  goes 
low,  generating  a  signal  which  is  fed  to  an  inverting  open 
collector  driver  to  generate  the  DCHREQ  signal  to  the  Nova. 
The  Q#  output  of  IC25a  is  also  connected  to  the  direct  clear 
input  of  IC25b.  This  causes  the  Q  output  of  IC25b  (DCHDON) 
to  go  low  each  time  a  DCH  request  is  generated.  The 
Cromemco  uses  the  low  DCHDON  signal  to  indicate  that  a  DCH 
is  in  progress.  When  the  Nova  honors  the  DCHREQ  signal  it 
responds  with  it’s  DCHACK  signal  via  IC26b.  This  causes 
IC25a  to  be  direct  cleared  which  removes  the  DCHREQ  signal. 
The  Nova  responds  with  DCH  SEL*DCHO#  or  DCH  SEL*DCHI#  after 
it  has  placed  the  appropriate  data  in  its  A  Port.  These  two 
response  signals  indicate  the  end  of  the  DCH  cycle  and  are 
"OR"ed  by  IC26a  to  form  a  signal  which  clocks  IC25b.  Since 
the  D  input  of  IC25b  is  tied  high,  the  Q  output  of  IC25b 
also  goes  high  generating  the  DCHDON  signal.  As  a  result  of 
setting  DCHDON,  the  circuit  has  completed  its  cycle  and  is 
ready  for  another  request.  The  Cromemco  must  only  initiate 
a  new  DCH  cycle  when  the  DCHDON  flag  is  high.  This  flag  is 
read  by  inputting  from  port  $D0  and  testing  the  next  to  the 
most  significant  bit.  Writing  to  I/O  port  $D0  allows  the 
direction  of  the  DCH  to  be  set  and  the  inhibiting  of  the 
DEVICE  COMPLETE  signal  when  the  contents  of  I/O  port  pair, 
$A0-$A1,  are  transferred  to  the  Nova.  The  two  most 
significant  bits  of  output  port  $D0  are  connected  to  the 
Nova's  MO  and  Ml  inputs  and  set  the  direction  for  a  DCH.  A 
pattern  of  "11"  sets  the  direction  for  input  to  the 


Cromemco,  while  a  pattern  of  "10"  sets  the  direction  for  the 
Cromemco  to  output  data.  Bit  5  of  this  port,  when  cleared, 
will  inhibit  the  Nova  A  Port  input  register  clock'  signal 
from  generating  a  DEVICE  COMPLETE#,  since  this  signal  is 
used  to  indicate  the  completion  of  a  DCH  data  block 
transfer . 

The  interface  has  been  thoroughly  tested,  with  the 
exception  of  the  16-bit  transfer  capability,  and  is  now 
completely  operational.  The  flexibility  that  was  designed 
into  its  circuitry  should  accommodate  most  of  the  possible 
future  enhancements  to  its  capabilities. 

The  software  which  allows  the  Cromemco  to  communicate 
over  the  channel  was  written  entirely  in  the  Z-80  assembly 
language.  Considerable  thought  was  given  to  using  a  High 
Order  Language,  but  the  only  two  available  for  the  Cromemco 
were  Fortran  and  Basic.  Neither  of  these  seemed  well  suited 
for  generating  the  required  software.  Although  Fortran 
would  not  have  been  the  optimum  language  to  use,  it  would 
definitely  have  been  a  better  choice  than  the  interpretive 
Cromemco  Basic.  The  inherent  slowness  of  this  Basic  was 
made  readily  apparent  after  running  several  BASIC  test 
routines  when  exercising  the  A/D  and  D/A  converters  for  the 
first  time.  The  major  drawbacks  of  Fortran  are  that  its 
bit  manipulation  capability  is  very  limited  and  the  memory 
requirements  for  the  compiler  generated  code  are  difficult 
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to  predict.  If  the  Cromemco  had  the  requirement  of  opening 
and  closing  disk  files  like  the  Nova,  then  access  to  the 
existing  Cromemco  operating  system  would  have  been 
necessary.  This  would  have  been  much  easier  from  Fortran 
and  could  possibly  have  reversed  the  decision  to  code  in 
assembly  language. 

The  assembly  language  of  the  Z-80  is  probably  one  of 
the  most  robust  of  the  existing  8-bit  micro  processors.  The 
/  mnemonics  are  much  easier  to  learn  and  employ  than  those  of 
its  predecessor,  the  8080.  The  Z-80  will  execute  all  of  the 
instructions  of  the  8080,  plus,  almost  as  many  again  of  its 
own.  This  richness  of  instructions  made  the  Z-80  an  ideal 
processor  in  which  to  implement  the  controlling  software  for 
this  side  of  the  channel. 

The  CHOPS  is  the  software  program  that  is  resident  in 
the  Cromemco  (see  Appendix  C).  Its  sole  purpose  is  to 
provide  a  link  between  the  hardware  resources  of  the 
Cromemco  and  the  processing  power  and  disk  storage  of  the 
Nova.  The  CHOPS  has  been  written  as  a  true  remote  operating 
system  which  remains  completely  transparent  to  the  Nova 
system  user,  since  the  user  communicates  with  it  through  the 
Nova's  CHANNEL  subroutine.  On  the  other  hand,  the  CHOPS 
does  not  itself  execute  the  commands  that  it  receives  from 
the  Nova.  It  only  provides  routines  to  transfer  information 
between  the  Cromemco  and  Nova,  observing  the  established 
comunication  protocol.  Therefore,  it  must  have  tasks 
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associated  with  each  command  coupled  to  it.  These  tasks 
can  be  written  to  implement  any  hardware  capability  in  the 
Cromemco. 

The  CHOPS  can  be  subdivided  into  five  major  areas 
consisting  of  the  command/parameter  collection  and  valida¬ 
tion  routine,  the  data  transfer  routines,  the  error  handling 
routine,  the  tasks,  and  the  command  table  (see  Figure  9). 
The  command/parameter  collection  and  validation  routine  is 
responsible  for  listening  via  programmed  I/O  to  either  the 
Nova  or  an  external  development  system  for  commands  and 
their  associated  parameters.  After  receiving  Nova  commands 
and  parameters,  this  routine  does  all  the  necessary  error 
checking,  then  communicates  the  status  of  the  commands  and 
parameters  to  the  Nova.  If  all  are  received  properly,  this 
routine  will  invoke  the  commanded  task  and,  if  the  task  is 
properly  written,  control  of  the  Cromemco  system  will  only 
be  partially  relinquished.  The  data  transfer  routines  are 
responsible  for  observing  all  of  the  communication  protocol 
required  for  programmed  I/O  or  DCH  transfers.  They  are 
invoked  by  a  task  to  receive  data  for  processing  or  output 
to  a  peripheral  or  to  send  data  to  the  Nova  that  has  been 
collected  by  a  peripheral.  The  transfer  technique  and  rou¬ 
tines  used  for  transferring  data  is  determined  by  the  Nova 
command  and  the  actual  task  software.  The  error  handling 
routines  provides  the  CHOPS  with  the  power  to  inform  the 
Nova  that  an  error  or  fault  has  occurred  either  during 
information  transfer  or  during  task  execution.  In  its 
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Figure  9.  CHOPS  Functional  Block  Diagram 
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present  form,  this  routine  automatically  deactivates  and 
terminates  a  task  in  which  an  error  has  occurred.  The  task 
routines  provide  the  Cromemco,  and  consequently  the  Nova, 
with  the  ability  to  utilize  resources  contained  within  or 
connected  to  the  Cromemco.  Without  the  tasks,  CHOPS  would 
not  know  what  to  do  with  data  it  receives  nor  would  it  ever 
have  any  data  to  send  to  the  Nova.  The  command  table 
provides  a  link  between  the  first  three  parts  of  the  CHOPS 
and  the  tasks  that  may  be  added  in  the  future.  This  table 
provides  an  address  for  the  command  information  list.  Each 
valid  command  has  a  list  containing  the  number  of  parameters 
to  be  expected  with  the  command,  the  bounds,  both  low  and 
high,  of  these  parameters  and  the  address  of  the  task 
routine  itself. 

If  an  instruction  by  instruction  description  of  the 
CHOPS  is  required,  the  listings  contained  in  Appendix  C  have 
been  generously  commented  and  should  provide  this  detail. 
The  following  discussion  deals  primarily  with  what  each 
routine  is  doing  rather  than  how  the  routine  does  it.  This 
information  should  be  extremely  beneficial  and  should  be 
read  first  before  attempting  to  understand  the  CHOPS  at  its 
Z-80  assembly  instruction  level. 

The  command/parameter  collection  and  validation  routine 
is  the  main  protocol  observer  of  the  CHOPS.  It  is  the 
routine  that  is  in  complete  control  of  the  Cromemco  when 
CHOPS  is  first  invoked.  This  routine  first  initializes  the 
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command  status  table,  prints  a  message  to  the  Cromemco 
console  screen  and  then  waits  for  a  command  from  either  the 
Nova  or  the  console  keyboard.  Currently,  the  console  key¬ 
board  serves  no  real  purpose.  It  is  simulating  a  capability 
that  a  remote  software  development  system  will  ultimately 
provide.  When  a  command  from  the  Nova  is  received,  the 
command  collection  portion  of  the  routine  tests  to  insure 
that  the  most  significant  bit  of  the  received  word  is  set. 
This  indicates  that  the  word  is  indeed  a  command.  If  the 
most  significant  bit  had  not  been  set,  the  CHOPS  would 
respond  with  an  error  and  wait  for  the  next  command  trans¬ 
mission.  When  a  true  command  word  is  received,  the  most 
significant  portion  of  the  command  and  the  direction  bit  are 
used  to  form  an  offset  into  the  command  table.  This  offset 
is  added  to  the  base  address  of  the  table  and  a  16-bit 
address  is  extracted  from  the  table.  For  a  command  word  to 
be  valid,  it  must  have  a  task  routine  available.  This  is 
signified  by  a  non-zero  most  significant  byte  of  the 
address  extracted  from  the  table.  This  address  points  to 
the  command  information  list  for  the  received  command. 

The  command  information  list  contains  a  one  byte  entry 
for  the  number  of  parameters  and  the  modes  that  a  command 
has  associated  with  it.  The  low  four  bits  indicate  the 
number  of  parameters  to  expect,  while  the  least  significant 
bit  of  the  upper  four  bits  indicates  that  the  command  is 
capable  of  invoking  either  mode  "01"  or  mode  "10"  data 
transfers.  Next,  it  contains  the  address  of  the  command 


status  byte.  Then  the  lower  and  upper  bounds  for  each  of 
the  parameters  are  listed  in  sequential  order.  The  actual 
memory  address  of  the  task  associated  with  this  command  is 
the  last  item  of  the  list  (see  Figure  10). 

When  a  command  has  been  validated  and  the  address  of 
its  information  list  retrieved,  the  next  test  of  the  command 
checks  to  insure  that  the  number  of  parameters  indicated  in 
the  Cromemco  word  P/E  field  is  correct.  If  this  test  is 
passed,  the  command  status  byte  address  from  the  command 
information  list  is  used  to  set  the  most  significant  bit  of 
the  command  status  byte  located  in  memory.  This  indicates 
that  this  command  is  now  active.  Only  after  passing  each  of 
these  tests  is  the  command  word  echoed  to  the  Nova.  If  any 
test  fails,  the  command  word  is  echoed  with  the  appropriate 
error  code. 

The  next  test  checks  the  mode  of  the  command.  If  a 
command  is  valid  for  all  modes,  the  data  mode  bit  will  be 
set  in  the  first  byte  of  the  command  information  list.  This 
byte  is  the  same  byte  that  was  used  when  checking  the 
received  parameter  count  against  the  expected  parameter 
count.  Since  commands  implementing  the  data  transfer  modes 
("01"  or  "10")  must  always  have  an  extra  parameter 
associated  with  them,  each  command  will  have  an  extra  pair 
of  bounds  in  the  list.  These  bounds  will  always  appear  as 
the  first  pair  in  the  information  list.  Since  the  routine’s 
Command  Information  List  Pointer  was  left  pointing  to  the 
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DW 
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FOLLOWING  ARE  THE  COMMAND  INFORMATION  LISTS. 

CILOOO : 

DB 

0 1 0H 

LO  NIBBLE  -  PARAMETER  COUNT 
HI  NIBBLE  -  DATA  FLAG  SET 

DW 

CMSTAT 

STATUS  LOCATION  FOR  OUTPUT 
TASK  00 

DW 

00000H 

DATA  COUNT  LO  BOUND 

DW 

00400H 

DATA  COUNT  HI  BOUND 

NO  ACTUAL  PARAMETERS  SINCE 
PARAMETER  COUNT  IS  ZERO 

DATA  COUNT  INCLUDED  SINCE 
DATA  FLAG  IS  SET 

DW 

TSKOOO 

ADDRESS  OF  TASK  00 

CIL00I: 

DB 

1 0H 

ZERO  PARAMETERS  -  SET  DATA 

DW 

CMSTAT+1 

STATUS  LOCATION 

DW 

00000H 

DATA  COUNT  LO  BOUND 

DW 

00400H 

DATA  COUNT  HI  BOUND 

• 

DW 

TSKOOI 

TASK  ADDRESS 

CIL010: 

DB 

012H 

TWO  PARAMETERS  -  SET  DATA 

DW 

CMSTAT+2 

STATUS  LOCATION 

DW 

00000H 

DATA  COUNT  LO  BOUND 

DW 

00400H 

DATA  COUNT  HI  BOUND 

DW 

00070H 

ONE  LESS  THAN  THE  MINIMUM 
SAMPLE  RATE  SETTING 

DW 

OFFFFH 

MAX.  SAMPLE  RATE  SETTING 

DW 

00000H 

ONE  LESS  THAN  THE  LOWEST 

A/D  CHANNEL 

DW 

000 1 0H 

HIGHEST  A/D  CHANNEL 

DW 

TSK010 

TASK  ADDRESS 

CIL01I: 

DB 

012H 

TWO  PARAMETERS  -  SET  DATA 

DW 

CMSTAT+3 

STATUS  LOCATION 

DW 

00000H 

DATA  COUNT  LO  BOUND 

DW 

00400H 

DATA  COUNT  HI  BOUND 

DW 

00070H 

ONE  LESS  THAN  THE  MINIMUM 
SAMPLE  RATE  SETTING 

DW 

OFFFFH 

MAX.  SAMPLE  RATE  SETTING 

DW 

00000H 

] 

ONE  LESS  THAN  THE  LOWEST 

D/A  CHANNEL 

DW 

00004H 

HIGHEST  D/A  CHANNEL 

DW 

TSK01I 

TASK  ADDRESS 

Figure  10.  CHOPS  Command  Information  List  Format 
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low  byte  of  the  low  bound  of  the  first  pair  in  the  list, 
an  error  would  occur  in  parameter  bounds  checking  if  this 
pair  were  used  for  the  non-data  modes  ("00"  or  "11")  for  the 
same  command.  Therefore,  when  the  same  command  is  received 
in  a  non-data  mode,  the  command  information  list  pointer 
must  be  advanced  four  bytes  to  effectively  skip  over  the 
extra  parameter  bounds.  The  routine  then  goes  into  a  loop, 
receiving  and  validating  parameters  and  echoing  the  status 
of  each  validation  to  the  Nova. 

After  all  parameters  have  been  collected  and  placed 
into  the  parameter  buffer,  the  task  address  is  extracted 
from  the  information  list.  The  mode  is  once  again  extracted 
from  the  command  word  and  used  to  generate  an  offset  from 
the  task  entry  point  address.  Mode  "00"  commands  enter  the 
task  with  no  offset,  while  each  of  the  other  modes  enter  two 
bytes  progressively  into  the  task. 

Each  task  must  have  four  jump  relative  instructions  at 
its  beginning  which  are  used  to  vector  the  task  to  the 
appropriate  command  service  routine  (see  Figure  11).  The 
task  must  also  provide  the  command  service  routine  as  a 
proper  Z-80  subroutine  that  executes  a  return  from  subrou¬ 
tine  when  it  is  completed.  If  an  error  occurs  during  sub¬ 
routine  execution,  the  CHOPS  requires  that  the  subroutine 
perform  a  proper  return  with  the  carry  flag  set  and  the  E 
register  loaded  with  the  proper  error  code.  For  a  non-error 
condition,  the  subroutine  must  return  with  the  carry  flag 
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ENTRY  TSKOOO , TSKOOI 


OUTPUT  TASK  00 


TSKOOO: 

JR 

OMODEO 

; MODE  "00"  ENTRY  POINT 

JR 

0M0DE1 

; MODE  "01"  ENTRY  POINT 

JR 

0M0DE2 

; MODE  "10"  ENTRY  POINT 

0M0DE3: 

• 

JP 

TCMPLT 

; MODE  "11"  ENTRY  POINT 

OMODEO: 

LD 

E , ERR6 

; MODE  "00"  NOT  AVAILABLE 
; SET  "INVALID  COMMAND  MODE 

• 

JP 

ERROR 

; TAKEN  TO  HANDLE  ERROR 

0M0DE1 : 

LD 

DE , DATOUT 

;GET  ADDRESS  OF  MODE  "01" 
-.OUTPUT  DATA  HANDLER 

JR 

GTOJOB 

; TAKEN  TO  CONTINUE  TASK 

; SET  UP 

0M0DE2 : 

LD 

DE.DCHOUT 

;GET  ADDRESS  OF  MODE  "10" 

; OUTPUT  DATA  HANDLER 

GTOJOB : 

CALL 

SBUFDF 

; SET  BUFFER  DEFAULTS 

LD 

HL, JOBOO 

;GET  JOB  ADDRESS 

• 

JP 

DOJOBO 

; LET  THE  CHOPS  DO  THE  WORK 

> 

i 

• 

INPUT 

TASK  00 

TSKOOI: 

JR 

OMODEO 

; MODE  "00"  ENTRY  POINT 

JR 

I MOD El 

; MODE  "01”  ENTRY  POINT 

JR 

IM0DE2 

; MODE  "10"  ENTRY  POINT 

JR 

0M0DE3 

; MODE  "11"  ENTRY  POINT 

IM0DE1 : 

LD 

DE , DATINP 

;GET  ADDRESS  OF  MODE  "01" 

; INPUT  DATA  HANDLER 

JR 

GTI JOB 

; TAKEN  TO  CONTINUE  TASK 

; SET  UP 

IM0DE2 : 

LD 

DE , DCHINP 

;GET  ADDRESS  OF  MODE  "10" 

; INPUT  DATA  HANDLER 

GTI JOB : 

CALL 

SBUFDF 

; SET  BUFFER  DEFAULTS 

LD 

HL, JOBOO 

;GET  JOB  ADDRESS 

JP 

DOJOBI 

; LET  THE  CHOPS  DO  THE  WORK 

t 

f 

JOB  00 

CONSISTS  OF 

A  NULL  JOB. 

JOBOO: 

SCF 

; CLEAR  CARRY  FLAG  SO 

CCF 

; CHOPS  THINKS  ALL  IS  OK 

RET 

END 

; END  OF  TASK  00 

Figure  11.  CHOPS 

Task  Coupling  Technique 
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cleared.  The  task  normally  places  the  address  of  its 
service  subroutine  in  the  HL  register  and  the  address  of  the 
CHOPS  data  transfer  routine  that  is  specified  by  the  command 
mode  in  the  DE  register.  These  addresses  are  then  passed 
back  to  CHOPS  via  an  absolute  jump  to  DOJOBO  or  DOJOBI  for 
output  and  input  tasks  respectively.  The  CHOPS  will  then 
handle  calling  of  the  service  routine  and  the  invoking  of 
the  required  data  handler  at  the  appropriate  stage  of 
command  execution.  If  the  task  requires  an  optimized  data 
transfer  capability,  the  task  can  intercede  at  this  point 
and  not  return  to  the  CHOPS  in  the  normal  manner.  When 
generating  such  tasks  great  care  should  be  taken  to  insure 
that  the  channel  communication  protocol  for  data  transfer 
is  strictly  observed.  Also,  for  these  tasks,  an  ultimate 
return  to  CHOPS  is  required  by  an  absolute  jump  to  the  task 
complete  (TCMPLT),  or  error  (ERROR),  routines.  If  an  error 
has  occurred,  the  code  for  the  error  must  be  placed  in  the  E 
register  before  accomplishing  the  jump  to  ERROR. 

The  data  handling  routines  exist  as  five  distinct 
routines.  Two  of  these  routines  allow  data  to  be  trans¬ 
ferred  via  programmed  I/O.  DATINP  is  for  inputting  data, 
while  DATOUT  is  for  outputting  data.  Likewise,  two  other 
routines  provide  data  transfer  via  the  DCH  capability  of  the 
Nova.  Again,  DCHINP  is  for  input,  whil^  DCHOUT  handles 
output.  The  fifth  routine  is  the  link  routine  which  allows 
the  input  or  output  service  routines  of  the  tasks  to  be 
linked  to  their  respective  data  handlers.  This  linking 


routine  has  two  entry  points.  DOJOBI  is  the  entry  point  for 
an  input  task,  while  DOJOBO  is  the  entry  point  for  an  output 
task.  Both  these  entries  expect  the  address  of  the  data 
handler  to  be  in  the  DE  register  and  the  address  of  the  job 
or  service  routine  to  be  in  the  HL  register.  With  this 
information,  the  linking  routine  will  properly  complete  the 
servicing  of  the  command  and  perform  the  proper  return  to 
the  command/parameter  collector. 

The  error  handling  routine  also  has  several  entry 
points.  These  entry  points  are  required  for  handling  the 
many  possible  error  modes.  The  task  completion,  TCMPLT, 
entry  point  is  also  embedded  into  the  error  handler  because 
its  function  of  deactivating  a  completed  task  is  very 
similar.  The  DE  registers  are  used  by  the  error  handler  to 
indicate  the  bits  to  be  set  in  the  echoed  command  word.  The 
D  register  normally  contains  the  error  and  status  bits, 
while  the  E  register  contains  the  error  code.  These  two 
registers  are  nOR"ed  onto  the  least  significant  byte  of  the 
command  word  to  indicate  the  proper  condition  immediately 
before  the  command  is  echoed.  The  error  handler  also 
incorporates  a  test  for  abort  commands.  Any  time  that  an 
improper  response  is  received  during  a  transaction,  it  is 
vectored  to  this  routine  to  test  for  an  abort  command.  If 
the  abort  is  detected,  the  command  will  be  sent  to  the 
command/parameter  validation  and  collection  routines  for 
servicing. 


During  their  execution,  the  main  routines  of  CHOPS  call 
numerous  subroutines  that  are  common  to  their  functions,  but 
the  majority  of  the  interchanges  are  accomplished  through 
absolute  jump  instructions.  These  jumps  are  necessary 
because  an  error  condition  could  occur  at  any  time.  If  one 
were  to  occur  in  a  subroutine  that  was  deeply  nested,  it 
could  be  very  difficult  to  properly  adjust  the  stack  before 
servicing  the  error.  This  could  lead  to  stack  overflow  and 
ultimately  to  catastrophic  failure  of  the  CHOPS.  With  the 
jump  technique,  each  of  the  modules  can  stand  alone  with 
control  being  safely  passed  between  them  without  the  concern 
of  causing  a  misadjusted  stack. 

The  CHOPS  has  been  written  to  support  a  possible  update 
to  multi-tasking.  This  is  the  primary  reason  that  a  command 
status  table  and  a  capability  for  aborting  commands  were 
incorporated.  For  multi-tasking,  an  interrupt  capability 
would  have  to  be  added  to  CHOPS  since  it  currently  does  not 
use  any  interrupts  for  its  own  controlling  purposes.  The 
interrupt  system  of  the  Cromemco  is,  however,  fully 
operational  and  can  be  employed  by  individual  tasks.  When 
using  interrupts,  extreme  care  should  be  taken  to  insure 
that  the  interrupts  are  disabled  before  returning  from  a 
command  service  subroutine.  If  this  is  not  done,  the  CHOPS 
will  have  no  way  of  regaining  control  of  the  system. 
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« 

The  I/O  channel,  in  its  final  form,  meets  all  the 
design  goals  that  were  set  for  the  joint  thesis.  The 
hardware  provides  a  reliable  path  over  which  the  Nova  and 
Cromemco  can  communicate.  This  communication  can  be 
accomplished  on  the  Nova's  side  of  the  channel  with  either 
programmed  I/O  or  the  DCH,  a  major  objective  of  the  thesis. 
A  means  of  transferring  speech  data  onto  and  off  of  the 
Nova's  disk  was  developed  early  enough  to  provide  a  data 
aquisition  capability  for  other  thesis  topics  which  had  to 
be  completed  months  before  this  one,  another  major 
objective.  Later,  software  was  developed  which  allowed  the 
Nova  to  control  the  I/O  Channel  without  the  interaction  of 
an  operator  at  the  Cromemco,  which  also  was  a  design  goal. 
The  CHOPS  provides  extensive  error  checking  and  allows  for 
the  addition  of  new  tasks  with  relative  ease.  In  addition, 
the  individual  writing  the  task  does  not  have  to  be 
intimately  familiar  with  the  CHOPS  or  the  I/O  Channel 
protocol.  The  Nova  CHANNEL  subroutine  handles  all 
communication  with  the  CHOPS  and  relieves  the  Nova  user  from 
having  to  understand  or  implement  the  communication 
protocol.  This  feature  makes  using  the  channel  a  simple 
'.h routine  call,  another  design  goal.  In  addition,  new 
. ;  tJilities  added  to  the  I/O  Channel  via  the  Cromemco  do 

-.^ulre  changes  in  CHANNEL,  again  a  major  design 


One  self  imposed  objective,  that  was  not  one  of  the 
original  design  goals,  was  to  transfer  speech  data  from  the 
Nova's  disk  in  real-time.  This  required  the  data  to  be 
transferred  from  the  Nova's  disk  at  a  rate  equal  to  or 
greater  than  the  desired  output  rate  of  the  D/A  converter. 
Accomplishing  this  would  allow  the  continuous  generation  of 
speech  for  a  duration  limited  only  by  the  storage  capacity 
of  the  disk.  To  test  the  feasibility  of  such  a  capability, 
the  DCH  transfer  rate  had  to  be  determined.  Unfortunately, 
time  did  not  allow  for  more  than  obtaining  a  crude  estimate 
of  the  DCH  transfer  time.  When  a  random  file  was 
transferred,  it  took  slightly  less  than  four  seconds  to 
transfer  about  four  seconds  of  speech  data.  With  contiguous 
files  the  transfer  took  approximately  two  seconds  for  the 
same  amount  of  speech  data.  Even  though  these  measurements 
were  quite  coarse,  they  revealed  great  promise  for  a  real¬ 
time  transfer  capability.  Hopefully,  further  development 
will  provide  this  capability  in  the  very  near  future. 

One  discouraging  problem  was  discovered  during  the 
development  of  the  CHOPS.  The  BUSY  and  DONE  flags  which 
were  used  as  handshake  signals  for  transfers  between  the 
Nova  and  Cromemco  seem  to  malfunction  at  times.  The 
Cromemco  is  required  to  set  the  DONE  flag  at  the  completion 
of  a  task,  but  sometimes  it  is  unable  to  set  this  flag. 
This  is  rather  puzzling  since  no  problems  were  ever 
encountered  when  the  DONE  flag  is  used  during  a  DCH 
transfer,  even  though  the  handshake  is  much  faster  and 
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considerably  more  critical.  Several  attempts  were  made  to 
rectify  this  problem  with  hardware,  but  none  were 
successful.  The  problem  seems  to  originate  from  the 
Cromemco  using  the  clock  input  of  the  DONE  flip-flop  to  set 
the  flag,  while  the  Nova  is  affecting  this  flag  via  the 
direct  set  and  direct  clear  of  the  flip-flop.  It  is 
suggested  that  a  logic  analyzer  be  used  to  more  thoroughly 
examine  the  problem.  Unfortunately,  time  constraints  again 
did  not  permit  this  trouble  shooting  to  be  accomplished.  To 
circumvent  this  problem  the  CHOPS  was  modified  to  test  the 
DONE  flag  after  each  time  it  attempts  to  set  it.  If  it  is 
set  the  CHOPS  will  continue,  but  if  it  is  not  set  the  CHOPS 
will  continue  to  attempt  to  set  the  flag  until  it  is  finally 
set.  It  was  discovered  that  this  loop  can  continue  for  up 
to  100  milliseconds,  it  allows  the  I/O  Channel  to  function 
until  the  problem  can  be  found  and  eliminated.  If  the  pre¬ 
wired  BUSY/DONE  network  should  prove  to  be  the  problem,  it 
will  have  to  be  redesigned  and  installed  in  the  breadboard 
section  of  the  GPI. 

It  should  be  emphasized  that  the  communications 
protocol,  CHANNEL,  and  CHOPS  are  all  orientated  toward 
multi-tasking.  They  were  designed  to  make  the  ultimate 
implementation  of  multi-tasking  as  easy  as  possible.  Multi¬ 
tasking  was  not  implemented  at  this  time  since  it  requires 
that  the' interrupt  capabilities  and  their  associated 
handlers  be  developed  for  both  systems.  Considering  the 
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already  extensive  nature  of  this  thesis,  it  would  not  have 
been  possible  to  complete  an  additional  development  of  this 
magnitude  in  the  time  available.  Before  adding  multi¬ 
tasking,  the  hardware  to  allow  the  Cromemco  to  load  the 
Nova's  B  Port  with  a  DCH  address  should  be  implemented  on 
the  GPI.  This  capability  would  allow  the  I/O  Channel  to 
receive  an  interrupt  and  extract  command/parameter 
information  from  a  pre-defined  area  of  the  Nova's  memory. 
After  executing  the  command  the  I/O  Channel  could  transfer 
the  completion  information  into  the  pre-defined  Nova  memory 
area  and  interrupt  the  Nova's  operation  to  indicate  that  the 
command  has  completed.  Utilization  of  this  technique  would 
speed  up  the  transfer  of  command  information  and  provide 
part  of  the  basis  for  a  multi-tasking  environment. 

The  CHOPS  software  should  be  placed  in  ROM.  It  was 
designed  to  reside  in  ROM  to  be  protected  from  being  over¬ 
written.  This  would  also  allow  the  removal  of  the  terminal 
and  disk  system  currently  attached  to  the  Cromemco.  The 
CHOPS  would  automatically  be  invoked  when  the  system  is 
powered  up  making  the  I/O  Channel  immediately  available  to 
the  Nova. 

It  is  suggested  that  a  software  development  system  for 
the  I/O  Channel  be  added  to  the  Speech  Lab.  The  Cromemco 
was  used  heavily  by  other  thesis  students,  making  it 
difficult  to  develop  additional  software  on  the  system.  A 
separate  development  system,  configured  much  like  the  I/O 


Channel  itself,  would  avoid  this  problem.  CHOPS  has 
provisions  in  it  for  communicating  with  such  a  system  via  a 
serial  port.  This  would  allow  software  to  be  written  and 
debugged  in  the  external  system  and  then  downloaded  into  the 
Cromemco  for  running  final  tests. 

When  these  enhancements  have  been  accomplished,  the  I/O 
Channel  will  provide  nearly  unlimited  capabilities  for  the 
Speech  Lab  user. 
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The  computer  bus  commonly 
known  as  the  S-100  was  first  intro¬ 
duced  by  MITS,  Inc.,  with  its  Altair 
kit.  This  bus  has  since  spread 
throughout  the  electronics  industry 
and  beyond.  Today  over  a  hundred 
manufacturers  make  products  which 
claim  to  be  compatible  with  the 
S-100  bus  even  though— until  now- 
no  complete  specification  has  been 
available.  The  following  table,  fig¬ 
ures.  and  notes  constitute  the  pre¬ 
liminary  draft  of  a  proposed  stand¬ 
ard  for  the  S-100  bus. 

This  document  is  a  specification  for 
both  timing  and  signal  disciplines. 
Signal  discipline  is  described  using 
the  bus  masler/bus  slave  language 
long  associated  with  Digital  Equip¬ 
ment  Corporation’s  PDP-11.  This 
point  of  view  facilitated  the  develop¬ 
ment  of  a  simple  and  highly  reliable 
DMA  protocol,  the  extended  addres¬ 
sing  capabilities,  and  the  16-bit  wide 
data  path  proposals.  These  exten¬ 
sions  to  the  original  Altair  bus 
represent  a  significant  advance  to 
the  state  of  the  art  of  small  com¬ 
puters  and  are  a  direct  result  of  a 
continuing  dialogue  with  a  large 
number  of  interested  people  who 
have  contributed  their  thoughts  and 
ideas  to  the  standards  committee. 
The  extended  address  and  data 
proposals  are  compatible  with  sys¬ 
tems  that  don't  use  these  features, 
including  most  existing  systems. 
Signals  which  are  defined  or  rede¬ 
fined  for  the  extensions  are  indicated 
by  an  asterisk 

The  preliminary  specification  will 
be  presented  at  the  1978  NCC  in 
June  in  Anaheim.  California.  Com¬ 
ments  can  be  made  at  that  time  or 
by  writing  to  George  Morrow. 


S-100  Bus  Signal  Definitions  (preliminary— subject  to  revision) 


PIN  NO 

SIGNAL  NAME  &  TYPE 

POLARITY 

DESCRIPTION 

1 

+  8  volts  <B)' 

Instantaneous  minimum  greater  than 

7  volts,  instantaneous  maximum  less 
than  25  volts,  average  maximum  less 
than  11  volts 

2 

+  16  volts  (8) 

Instantaneous  minimum  gi  eater  than 
14  voils.  instantaneous  maximum 
less  than  35  volts  average 
maximum  less  than  20  volts 

3 

XRDY  (S)’  ,#  ■ 

positive 

One  ol  two  really  inputs  10  the 
current  bus  maste'  The  Dus  is 
really  when  both  these  ready 
inputs  are  true 

4 

VIO  IS)'0 

negative 

Vectored  interrupt  line  0 

3 

VII  (Si’0 

negative 

Vectored  interrupt  line  l 

6 

VI2  IS)’0 

negative 

Vectored  interrupt  line  2 

7 

vi3  isr0 

negative 

Vectored  interrupt  line  3 

8 

VI4  (S)’° 

neqative 

Vectored  interrupt  line  4 

9 

VI5  fSl'° 

negative 

Vectored  interrupt  line  5 

10 

vi6  isr" 

negative 

Vectored  interrupt  linn  g 

11 

VI7  (S)'° 

negative 

Vectored  interrupt  ne  7 

12 

- 

- 

Not  specified 

13 

- 

- 

Noi  specified 

14 

, 

- 

Not  specified 

18 

- 

- 

Not  specified 

16 

- 

- 

Not  specified 

17 

- 

- 

Not  specihed 

18 

STAT  DSBIM)'  " 

negative 

The  control  signal  to  disable 
the  9'  status  sipna's  1 

19 

C't  d5b  (Ml" 

neqative 

The  control  signal  to  disable  the 

6  command /control  signals  ’ 

20 

UNPROT 

- 

Not  specified 

21 

SS 

- 

Not  spec  died 

22 

ADb  55b  iM)’” 

negative 

The  control  signal  to  disable 

-  -  - 

81 

the  t6  address  signals  * 

1 


S  100  Bus  Signal  Definitions  (preliminary— subject  to  revision) 


SIGNAl  NAME  &  TYPE 


00  DSB(W)' 


POLARITY  DESCRIPTION 


The  coniroi  signal  to  disable 
the  8  data  output  signals  * 


?4 

♦?  (Bl 

positive 

The  master  timing  signal  (or 
the  bus 

25 

4. 

- 

Not  specified 

26 

PHLDA (M) 

positive 

A  command/conlrol  signal  used 
in  conjunction  with  PH0LD  to 
coordinate  bus  master  transfer 
operations 

27 

PWAIT  (Ml 

positive 

The  acknowledge  signal  to  either 
ol  the  bus  ready  signals  XRDY. 
PROY  or  to  a  HLT  instruction 

28 

PINTE 

positive 

Not  specified 

n 

AS  (Ml 

positive 

Address  bit  5 

30 

A4  IMl 

positive 

Address  bit  4 

31 

A3  (Mi 

positive 

Address  bit  3 

32 

A15 (M) 

positive 

Address  bit  15  (most  significant 
lor  non-extended  addressing) 

33 

A12 (Ml 

positive 

Address  bit  12 

34 

A9  (Ml 

positive 

Address  bit  9 

*35 

001  (M1/A17  (Ml/DATAI  (M/S)" 

|;  positive 

Data  out  bit  1 .  extended  address 
bit  17.  bidirectional  data  bit  1 

•36 

D00  (M1/A16  (MI/DATAO  (M/S) 

positive 

Data  out  bit  0  extended  address 
bit  16  bidirectional  data  bit  0 
(least  significant) 

37 

AtO  (Ml 

positive 

Address  bit  10 

*38 

004  (M)/A20  (M)/DATA4  (M/S) 

positive 

Data  out  bit  4  extended  address 
bit  20  bidirectional  data  bit  4 

•39 

005  (MI/A21  (MI/0ATA5  (M/S) 

positive 

Data  out  bit  5  extended  address 
bit  2i  bidirectional  data  bn  5 

•40 

006  (M1/A22  (M1/DATA6  (M/S) 

positive 

Data  out  bit  6  extended  address 
bit  22  bidirectional  data  bit  6 

•41 

012  (M)/DATA10(M/S)‘ 

positive 

Data  m  bit  2  bidirectional  data 
bn  10 

*4? 

013  ( M ) / DA T A 1 1  (M/S) 

positive 

Data  m  bit  3  bidirectional  data 
bit  it 

•43 

017  (MI/0ATA15  (M/Sl 

positive 

Oata  m  bit  7  bidirectional  data 
bit  15  (most  significant) 

44 

SMI (M) 

positive 

The  status  signal  which  indicates 
that  (he  cu'ient  r  cle’  is  an 
op  code  letch 

45 

S0UT (Ml 

positive 

The  status  signal  identifying  th- 
data  nanslei  bus  cycle  of  an  OUT 
instruction 

46 

SINP  (M) 

positive 

The  status  signal  identilying  the 
data  transfer  bus  cycle  of  an  IN 
instruction 

47 

SMEMR IMl 

positive 

The  status  signal  identifying  bus 
cycles  which  tianster  data  horn 
memory  to  a  bus  master  which  are 
not  interrupt  acknowledge 
instruction  letch  eyelets) 

48 

SHITA  (Mi 

positive 

The  status  signal  which  acknowi 

edges  that  a  HLT  instruction  has 
been  executed 


Thinker  Toys.  1201  10th  St  reel. 
Berkeley,  CA  94707  or  to  Robert  (J. 
Stewart.  1658  Belvoir  Drive.  l,os 
Altos.  CA  94022. 

The  committee  is  currently  con¬ 
sidering  proposals  for  DMA  and 
interrupt  priority  specifications 
These  will  be  made  public  in  the 
near  future— perhaps  at  the  NCC 
meeting 


Bus  signal  notes  (see  table) 

1.  There  are  three  types  of  signals 
on  the  S-100  bus.  M  stands  for  bus 
master.  Signals  designated  by  (Ml 
are  those  which  a  bus  master  must 
generate.  The  bus  master  currently 
controlling  the  bus  has  the  responsi¬ 
bility  for  faithfully  generating  all 
signals  of  type  M  during  its  control 
of  the  bus 

S  stands  for  bus  slave.  A  bus  slave 
need  generate  only  that  subset  of 
type  S  signals  which  are  necessary 
to  communicate  with  bus  masters 
which  have  the  ability  to  address 
the  slave. 

B  stands  for  bus.  Any  bus  signal 
which  is  not  of  type  M  or  S  is  by 
default  type  B.  This  is  not  to  say 
that  some  bus  master  is  not  in  fact 
generating  one  or  more  type  B  sig¬ 
nals.  Rather  a  type  B  signal  is  one 
that  (al  not  all  bus  masters  Bre 
required  to  generate,  and  (bl  not  any 
bus  slave  is  required  to  generate. 

A  bus  master  is,  bv  definition,  a 
bus  device  which  generates  at  least 
all  of  the  type  M  signals  A  bus 
slave  is  a  bus  device  which  generates 
some  subset  of  type  S  signals  A  bus 
master  may  also  be  a  bus  slave  and 
vice-versa.  Memory  devices  are 
almost  always  bus  slaves  while 
DMA  devices  are  usually  both  a 
bus  master  (data  transfers)  and  a 
bus  slave  (accepting  commands) 
Central  processing  units  are  usually 
bus  masters 

2.  The  9*  status  signals  are 
RMFMR.  SIM*.  SMI  SOl'T. 
SUITA.  SSTACK  (not  specified). 
SWTl  SINTA.  and  SXTRQ 

3.  The  6  commandcontrol  sig 
nals  are  PHI-DA.  PSYNC.  PUB  IN. 
PINTK  (not  specified).  PVVR.  and 
PWAIT 

4  The  16  address  signals  are 
A 1 5.  A14,  A 1 3.  A 12.  All.  AID.  A9. 
AH.  A7.  A6.  A5.  A4.  A3.  A2.  Al, 
and  A0 

5.  Data  output  is  specified  relative 
to  a  bus  master  By  definition,  data 
which  is  transmitted  bv  a  bus 


master  is  always  data  output  and 
occurs  on  the  DO  bus  or  DATA* 
bus. 

6.  Data  input  is  specified  relative 
to  a  bus  master.  By  definition,  data 
which  is  received  by  a  bus  master  is 
always  data  input  and  occurs  on  the 
DI  bus  or  DATA*  bus. 

7.  A  bus  cycle  is  a  collection  of 
bus  states  (BS0|.  A  bus  cycle  always 
starts  with  a  BS,  state  which  is 
followed  by  a  BS,  state.  After  BS, 
comes  an  indeterminate  number  of 
BS..  (bus  wait)  states.  A  bus  cycle 
may  have  zero  BS..  states  or  it  may 
have  an  arbitrarily  large  number  of 
BS..  states.  BS,  is  the  bus  state 
which  follows  BS..  (or  BS,  if  there 
are  no  BS„  states  present).  BS,  is 
followed  by  zero  or  more  BS,  (bus 
idle)  states.  A  BS,  or  BS,  state 
terminates  a  bus  cycle. 

8.  The  DO  bus  is  the  following  set 
of  signals:  D07.  D06,  D05.  D04. 
D03.  D02.  DOl,  and  DOO. 

9.  The  DI  bus  is  the  following  set 
of  signals:  DI7.  DI6.  D15.  DI4.  DI3, 
DI2.  Dll.  and  DIO. 

10.  These  signals  should  be  gen¬ 
erated  by  an  open  collector  bus 
driver  capable  of  sinking  at  least 
24  mA  at  no  more  than  0.5  volts. 

•11.  During  the  last  half  of  bus 
state  1  and  the  first  half  of  bus 
state  2,  the  DO  lines  are  used  to 
furnish  extended  addressing  to 
slaves  that  can  utilize  this  informa¬ 
tion. 

•12.  For  16-bit  masters  and  slaves, 
the  DI  and  DO  lines  gang  together 
to  form  a  16-bit  bidirectional  data 
bus  called  DATAO-15.  The  DO  lines 
carry  the  low-order  byte  while  the 
DI  lines  accommodate  the  high-order 
byte.  The  configuration  of  the  DI 
and  DO  buses  is  governed  by  the 
signals  SXTRQ  and  SIXTN.  When 
both  these  signals  are  low,  the  DI 
and  DO  lines  become  bidirectional. 
Otherwise.  DI  carries  the  data  to 
the  current  master  while  DO  carries 
data  to  the  addressed  slave. 


Signal  characteristics 

Bus  drivers  must  sink  at  least 
24  mA  at  no  more  than  0.5  volts. 
Except  for  open  collector  drivers, 
they  must  source  at  least  2  mA  at 
no  less  than  2.4  volts. 

Bus  receivers  must  have  diode 
clamps  to  prevent  excessive  nega¬ 
tive  excursions.  Any  bus  signal  less 
than  0  8  volts  must  be  recognized 
as  a  logic  zero,  and  any  signal  more 


S-100  Bus  Signal  Definitions  (preliminary— subject  to  revision) 


PIN  NO 

SIGNAL  NAME  &  TYPE 

POLARITY 

DESCRIPTION 

49 

CLOCK  <B) 

- 

2  MHr  .  40-60%  duty  cycle  Not 
required  to  be  synchronous  with 
any  other  bus  signals 

50 

GN0 

Signal  and  power  ground 

51 

-4-  8  volts  (8) 

See  comments  lor  pin  number  t 

52 

- 16  volts  (B) 

Instantaneous  maximum  less  than 
-14  volts  instantaneous  minimum 
greater  than  -35  volts  average 
minimum  greater  than  -  20  volts 

53 

SSWI 

- 

Not  specified 

54 

EXT  fcLh 

negative 

A  reset  signal  to  rest  bus  slaves 

When  this  signal  goes  low  H  must 
stay  low  tor  at  least  3  bus  states 

55 

- 

- 

Not  specitied 

56 

- 

- 

Not  specitied 

57 

- 

- 

Not  specified 

58 

- 

- 

Not  specified 

•59 

SxTfiotM) 

negative 

The  status  signal  which  requests 

16  bit  wide  slaves  to  respond 
by  asserting  SIXTN 

60 

- 

- 

Not  specified 

•61 

SIXTN  (S) 

negative 

The  signal  generated  by  16-bit 
slaves  in  response  to  the  16-b't 
request  status  signal  SXTRQ 

62 

- 

- 

Not  specified 

63 

- 

- 

Not  specilied 

64 

- 

- 

Not  specified 

65 

- 

- 

Not  specihed 

66 

- 

- 

Not  specified 

67 

PHANTOM  (B) 

negative 

A  bus  signal  which  disables  normal 
slave  devices  and  enables  phantom 
slaves  — primarily  used  for 
bootstrapping  systems  without 
hardware  front  panels 

68 

MWRITE  (B) 

positive 

MWRUE  =  (PWRi  .  S0UT  This 
signal  must  follow  PWR  bv  not 
more  than  30  ns 

69 

PS 

- 

Not  specified 

70 

PR0T 

- 

Not  specified 

71 

RUN 

- 

Not  specilied 

72 

PR0Y  <S)'° 

positive 

See  comments  lor  pin  number  3  . 

73 

■  PINT  (S)'° 

negative 

The  primary  interrupt  request 
bus  signal 

74 

PH0LD  (M)’° 

negative 

The  command/control  signal  used  in 
conjunction  with  PHLDA  to  coordinate 
bus  master  Iranster  operations 

75 

PRESET  (B)’° 

negative 

The  reset  signal  to  reset  bus  master 
devices  When  this  signal  goes  low 
it  must  stay  low  lor  at  leasi  3  bus 
states 

than  2  volts  must  be  interpreted  as 
a  logic  one. 

Receivers  are  to  source  no  more 
than  0.8  mA  at  0.5  volts  and  are  to 


sink  no  more  than  80  mA  at  2  4 
volts.  The  capacitance  load  of  an 
input  from  the  bus  must  not  exceed 
25  pF 


83 


S-100  Bus  Signal  Oellnilions  (preliminary— subject  to  revision) 


PIN  NO 

SIGNAL  NAME  &  TYPE 

POLARITY 

DESCRIPTION 

76 

PSYNC  (Ml 

positive 

The  command /control  signal  identify¬ 
ing  BS,  (See  bus  state  comments  ) 

77 

PWR  (Ml 

negative 

The  command/control  signal  signify¬ 
ing  the  presence  of  valid  data  on 

00  bus*  Of  DATA*  bus  ” 

78 

PDBIN  (M) 

positive 

The  command/control  signal  that 
requests  data  on  the  Dl  bus*  or 

0ATA*  bus’1  from  the  currently 
addressed  slave 

79 

AO  IM) 

positive 

Address  bit  0  (least  sioniticant) 

80 

A1  (M) 

positive 

Address  bit  1 

81 

A2IM) 

positive 

Address  bit  2 

82 

A6  (M) 

positive 

Address  bit  6. 

83 

A7(M) 

positive 

Address  bit  7 

84 

A8  (M) 

positive 

Address  bit  8 

85 

A13  (M) 

positive 

Address  bit  13 

86 

A14  (M) 

positive 

Address  bit  14 

87 

All  (M) 

positive 

Address  bit  1 1 

*88 

002  (M)/A18  (M1/DATA2  (M/S) 

positive 

Data  out  bit  2  extended  address 
bit  18  and  bidirectional  data  bit  2 

*89 

D03  (M)/A19  (MI/DATA3  (M/S) 

positive 

Data  out  bit  3  extended  address 
bit  19  and  bidirectional  data  bit  3 

*90 

007  (M)/A23  (M)/0ATA7  (M/S) 

positive 

Data  out  bit  7  (most  significant  tor 

8-bit  data)  extended  address  bit  23. 
and  bidirectional  data  bit  7 

*91 

DI4  (S)/DATA12  (M/S) 

positive 

Data  in  bit  4  and  bidirectional  data 
bit  12 

*92 

DI5  (S1/0ATA13  (M/s) 

positive 

Data  in  bit  5  and  bidirectional  data 
bit  13 

*93 

DI6  (SI/DATA14  (M/S) 

positive 

Data  in  bit  6  and  bidirectional  data 
bit  14 

*94 

OH  (S1/DATA9  (M/S) 

positive 

Data  in  bit  1  and  bidirectional  data 
bit  9 

*95 

010  (SI/0ATA8  (M/S) 

positive 

Data  in  bit  0  (least  significant  tor 

B-bit  data)  and  bidirectional  data 
bit  8 

96 

SINTA  (Ml 

positive 

The  status  signal  identifying  the 
Instruction  (etch  eyelets)  that  imme¬ 
diately  follow  an  accepted  interrupt 
request  presented  on  PINT 

97 

SW0  (Ml 

negative 

The  status  signal  identifying  a  bus 
cycle  which  transfers  data  Irom  a 
bus  master  to  a  slave 

98 

SSTACK 

- 

Not  specified 

99 

R5C  IB) 

negative 

The  power-on  clear  signal  lor  an  bus 
devices  when  this  signal  goes  low 
it  must  stay  low  tor  at  least  3  bus 
states 

100 

GN0 

Signal  and  power  ground 

Bus  slate  comments 

BS.  is  the  initial  bus  state  of  a 
bus  cycle.  The  address  lines,  data 


and  status,  are  in  a  state  of  flux 
during  most  of  BS.,  and  PSYNC 
is  active  starting  with  the  second 
half  of  BS,. 


BS.-  is  the  second  bus  state  when 
address  data,  status,  and  ready  sig¬ 
nals  become  stable. 

BS„  states  occur  as  needed  to 
synchronize  a  bus  master  with  a  bus 
slave  which  has  brought  one  of  the 
ready  lines  false. 

BS,  is  the  data  transfer  state 
when  a  bus  master  I ranalera  data 
to  a  slave  or  vice-versa. 

BS,  is  a  state  during  which  the 
bus  is  idle. 


Timing  notes 

All  timing  references  in  the  tim¬ 
ing  diagrams  (Figures  1  and  2)  are 
specified  at  the  midpoint  of  the 
rising  or  falling  edge  of  the  signal 
Rise  and  fall  times  are  not  to  exceed 
50  ns. 

All  signals  referred  to  in  the  tim¬ 
ing  diagrams  are  S-100  bus  signals 
with  the  exceptions  in  Note  6. 

1.  The  falling  edge  of  PWR  must 
occur  within  the  area  shown  The 
rising  edge  must  occur  within  a 
similar  area  of  the  next  bus  state. 

2.  BS0  is  either  BS,  or  BS„. 

3.  Addresses,  data  output,  and 
status  signals  must  remain  stable 
during  BS„ . 

4.  The  interrupt  lines  must  be 
sampled,  bv  the  CPU  or  interrupt 
controller,  during  the  stable  period 
shown  in  the  bus  state  preceding 
BS,  of  an  op  code  fetch  This  does 
not  imply  that  the  interrupt  line 
must  be  stable  during  this  period. 
However,  if  an  interrupt  line  is 
asserted  true  during  this  period, 
then  it  is  not  defined  whether  an 
interrupt  will  occur  before  the  next 
instruction  is  executed.  Once  an 
interrupt  line  is  asserted  true,  it 
should  remain  true  until  the  CPU 
responds.  Normally,  this  response 
would  be  an  I/O  instruction  that 
addresses  the  interrupting  device. 

5  The  rising  edge  of  PWA1T 
must  occur  within  the  area  shown. 
The  falling  edge  must  occur  within 
a  similar  area  following  the  rising 
edge  of  the  logical  AND  of  PRDY 
and  XRDY. 

6.  Signals  prefixed  by  "DMA" 
refer  to  internal  logic  of  the  new 
bus  master.  These  signals  control 
the  buffers  of  this  bus  master  which 
drive  the  command  and  control, 
status,  address,  and  data  output 
bus  lines.  The  timing  diagram 
depicts  logic  levels  which  are  high 
when  these  buffers  are  disabled. 


bn 


7.  BSfl  is  either  BS,  or  BS,. 

8.  BSr  is  either  BS  or  BS,. 

*9.  Extended  address  bits  A 16 
through  A23  are  multiplexed  on 
the  DO  lines.  They  must  occur  as 
shown  within  250  ns  after  the  rising 
edge  of  ♦,  during  BS,.  During  a 
write,  dula  must  appear  on  these 
lines  100  ns  before  PWR  is  active. 
The  PWTt  signal  can  be  asserted  as 
soon  as  5  ns  after  the  rising  edge 
of  4?  during  BS2.  Therefore,  under 
worst  case  conditions,  the  extended 
addresses  are  on  the  bus  for  155  ns. 
Masters  can  generate  PWk  later  as 
shown.  This  would  allow  the  ex¬ 
tended  addresses  to  be  on  the  bus 
longer.  However,  slaves  should  be 
designed  to  correctly  respond  in 
the  worst  case  situation. 

*10.  To  avoid  conflict  on  the  DO 
lines  during  a  16-bit  read,  similar 
to  the  situation  described  in  Note  9 
above,  the  extended  addresses  must 
be  removed  from  the  DO  lines  before 
the  rising  edge  of  PDBIN. 

Direct  memory  access 
requirements 

A  DMA  cycle  is  a  special  case 
of  a  bus  master  taking  over  the  bus 
to  execute  a  memory  read  or  write 
cycle.  A  DMA  device  is  required 
to  generate  all  type  M  (bus  master) 
signals  on  the  bus,  and  control  the 
bus  exchange.  _ 

The  bus  exchange.  PHOLD  is  the 
signal  used  by  one  bus  master  to 
request  that  another  bus  master  give 
up  control  of  the  bus.  PTTOTT)  must 
not  be  asserted  true  unless  PHLDA 
is  false. 

One  bus  master  (CPU)  relinquishes 
control  of  the  bus  to  another  (DMA) 
as  shown  in  the  bus  exchange  timing 
diagram.  The  DMA  device  must 
control  the  CPU's  bus  drivers 
through  the  use  of  ADD  DSB.  DO 
flisTV  STaT  DSB.  and  UC,  I)SF)  It 
must  also  control  its  own  bus  drivers 
through  the  use  of  signals  similar 
to  t  hose  shown  in  Note  6. 

The  CPU  (current  master)  and  the 
DMA  device  (new  master)  must  both 
drive  the  command  and  control  sig¬ 
nals  for  at  least  200  ns  at  two  dif¬ 
ferent  periods  as  shown  in  the  bus 
.exchange  timing  diagram.  During 
these  two  times,  the  command  and 
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Figure  2.  Proposed  DMA  protocol  (preliminary— subject  to  revision). 


control  signals  are  required  to  have 
the  following  levels:  (1)  PSYNC  =  0: 
(21  PWAIT  =  0;  (3)  PHLDA  =  1; 
(4)  PDBIN  =  0:  and  (5)  PWR  =  1. 

The  DMA  cycle  timing  sequence 
which  follows  is  a  suggested  imple¬ 
mentation  that  meets  all  the  require¬ 
ments  of  the  generalized  bus  exchange 
timing.  The  sequence  is  controlled 
by  the  edges  of  4\>.  At  some  previous 
time,  PHOLD  was  asserted  accord¬ 
ing  to  the  limitations  described  in 
the  first  paragraph  of  this  section. 
PHLDA  is  asserted  true  by  the  CPU 
during  BS,  of  the  last  CPU  bus 
cycle  The  bus  exchange  begins  on 
the  falling  edge  of  4,  while  PHLDA 
is  true  (labeled  1  on  the  timing 
diagraml.  The  DMA  bus  cycle  then 
proceeds  as  described  in  the  follow¬ 
ing  section  At  edge  8  of  ♦,  f»HOLD 
is  driven  false  by  the  DMA  device 
and  henceforth  the  CPU  is  again 
in  control  of  the  bus. 

Proposed  DMA  cycle  sequence. 

♦  ;  edge: 

1  CPU  address  and  data  bus 
drivers  turned  off.  DMA  command 
and  control  drivers  turned  on  The 
CPU  and  DMA  command  and  con¬ 
trol  signals  must  match  the  levels 
described  in  the  previous  section. 

2.  CPU  status  and  command  and 
control  drivers  turned  off.  DMA 
address,  data  output,  and  status 
drivers  turned  on.  PSYNC  =  1. 

3.  No  change 


4.  PSYNC  =  0  PDBIN  =  1  if 
memory  read  or  PWR  =  0  if  mem¬ 
ory  write. 

5.  No  change  _ _ 

6.  PDBIN  =  0  and  PWR  =  1 

7.  CPU  command  and  control 
drivers  turned  on.  DMA  address  and 
data  output  drivers  turned  off. 

8.  CPU  address,  data  output,  and 
status  drivers  turned  on.  DMA 
status  and  command  and  control 
drivers  turned  off.  PHOLD  =1 

Multiple  dala  transfers  can  occur 
by  repeating  steps  2  through  6  ■ 
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Appendix  B 


Cromemco  I/O  Port  Assignments 


Port  i 

Direction 

Function 

Carjj 

00 

Input 

Console  status 

4FDC 

00 

Output 

Console  baud  rate 

4FDC 

01 

In/Out 

Console  data 

4FDC 

02 

Output 

Console  command 

4FDC 

03 

Input 

Console  interrupt  address 

4FDC 

03 

Output 

Console  interrupt  mask 

4FDC 

04 

In/Out 

8-Bit  parallel  I/O  data 

4FDC 

05 

Output 

#1  Interval  timer 

4FDC 

06 

Output 

#2  Interval  timer 

4FDC 

08 

Output 

#4  Interval  timer 

4FDC 

09 

Output 

#5  Interval  timer 

4FDC 

30 

Input 

Disk  status 

4FDC 

30 

Output 

Disk  command 

4FDC 

31 

In/Out 

Disk  interrupt  mask 

4FDC 

32 

In/Out 

Disk  sector 

4FDC 

33 

In/Out 

Disk  data 

4FDC 

3^ 

Input 

Disk  flags 

4FDC 

34 

Output 

Disk  control 

4FDC 

AO 

In/Out 

DCH  low  byte  data 

Crom/Nova 

A1 

In/Out 

DCH  high  byte  data 

Crom/Nova 

BO 

In/Out 

DCH  address  low  byte 

Crom/Nova 

B1 

In/Out 

DCH  address  high  byte 

Crom/Nova 

CO 

In/Out 

Low  byte  command  and  data 

Crom/Nova 

Cl 

In/Out 

High  byte  command  and  data 

Crom/Nova 

C2 

Output 

DCH  transfer  request 

Crom/Nova 

DO 

Input 

Channel  status  flags 

Crom/Nova 

DO 

Output 

Channel  control 

Crom/Nova 

EO 

Input 

Master  interrupt  status  #0 

CPU  Support 

EO 

Output 

Master  interrupt  control  #0 

CPU  Support 

El 

Input 

Master  interrupt  status  #1 

CPU  Support 

El 

Output 

Master  interrupt  control  //I 

CPU  Support 

E2 

Input 

Slave  interrupt  status  #0 

CPU  Support 

E2 

Output 

Slave  interrupt  control  #0 

CPU  Support 

E3 

Input 

Slave  interrupt  status  #1 

CPU  Support 

E4 

Output 

Slave  interrupt  control  //I 

CPU  Support 

E4 

In/Out 

Timing  controller  data 

CPU  Support 

E5 

Input 

Timing  controller  status 

CPU  Support 

E5 

Output 

Timing  controller  control 

CPU  Support 

E6 

In/Out 

Serial  data 

CPU  Support 

E7 

Input 

Serial  status 

CPU  Support 

E7 

Output 

Serial  control 

CPU  Support 

E8 

In/Out 

8-Bit  parallel  I/O  data 

CPU  Support 

E9 

Input 

8-Bit  parallel  I/O  status 

CPU  Support 

E9 

Output 

8-Bit  parallel  I/O  control 

CPU  Support 

FO 

Output 

D/A  #4  higher  four  data  bits 

D/A 

FI 

Output 

D/A  it 4  lower  eight  data  bits 

D/A 

F2 

Output 

D/A  it  1  higher  four  data  bits 

D/A 
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Port  # 

Direction 

Func tiffin 

Card 

F3 

Output 

D/A 

#1  lower  eight 

data 

bits 

D/A 

F4 

Output 

D/A 

#2  higher  four 

data 

bits 

D/A 

F5 

Output 

D/A 

#2  lower  eight 

data 

bits 

D/A 

F6 

Output 

D/A 

#3  higher  four 

data 

bits 

D/A 

F7 

Output 

D/A 

#3  lower  eight 

data 

bits 

D/A 

F8 

Output 

A/D 

channel  select 

A/D 

F9 

Output 

A/D 

control 

A/D 

F9 

Input 

A/D 

status 

A/D 

FA 

Input 

A/D 

lower  eight  data  bits 

A/D 

FB 

Input 

A/D 

higher  four  data  bits 

A/D 

FF 

Output 

Video  digitizer  control 

Video 
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NOVA/C  ROMEMCO 


CHANNEL  OPERATING  SYSTEM 
CHOPS 
MAIN  SYSTEM  ROUTINES 
VERSION  2.0 

WRITTEN  BY 

CAPT  GEORGE  C.  BEASLEY,  JR.,  USAF 
MARCH  1981 


THE  ONLY  EXTERNAL  ADDRESS  REQUIRED  BY  THE  CHOPS  IS 
THE  COMMAND  TABLE  STARTING  ADDRESS.  THE  FOLLOWING 
DECLARATION  ALLOWS  THIS  ADDRESS  TO  BE  PROVIDED 
DURING  LINKING. 

EXT  COMTBL  ; ENTRY  POINT  FOR  THE  COM¬ 

MAND  TABLE  AND  COMMAND 
; INFORMATION  LIST 


THE  FOLLOWING  LABELS  HAVE  BEEN  MADE  GLOBAL  FOR  USE 
IN  EXTERNAL  TASKS. 


THE  FOLLOWING  ARE  THE  ENTRY  POINTS  FOR  THE  VARIOUS 
PROTOCOL  HANDLING  AND  LINKAGE  ROUTINES. 

ENTRY  TCMPLT, ERROR , DATOUT, DATINP, DCHOUT, DCHINP 

ENTRY  DOJOBO , DOJOBI , BNDTST, WRNOVA, RDNOVA, TSTDON 
ENTRY  SBUFDF 


THE  FOLLOWING  ARE  THE  ADDRESSES  OF  THE  CHOPS 
VARIABLE  STORAGE  LOCATIONS  AVAILABLE  FOR  USE  BY 
EXTERNAL  TASKS. 

ENTRY  LOMEM, HIMEM, DATSTR , DA TEND, PRMBUF, CMSTAT 

ENTRY  USERAM 
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THE  FOLLOWING  ARE  THE  SYSTEM'S  I/O  PORT  ASSIGNMENTS 


CONSTS: 

EQU 

OOOH 

; CONSOLE  STATUS  PORT 

CONDAT: 

EQU 

001H 

; CONSOLE  DATA  PORT 

DCHLO : 

EQU 

OAOH 

;DCH  DATA  LO  BYTE  PORT 

DCHHI : 

EQU 

OA1H 

; DCH  DATA  HI  BYTE  PORT 

ADDRLO : 

EQU 

OBOH 

; DCH  ADDRESS  LO  BYTE  PORT 

ADDRHI : 

EQU 

OB1H 

; DCH  ADDRESS  HI  BYTE  PORT 

DATALO: 

EQU 

OCOH 

;LO  BYTE  COMMAND  AND  DATA 

DATAHI : 

EQU 

OC1H 

; HI  BYTE  COMMAND  AND  DATA 

DCHREQ : 

EQU 

0C2H 

; DCH  TRANSFER  REQUEST  PORT 

FLAGS: 

EQU 

ODOH 

; NOVA  STATUS  FLAGS  PORT 

DCHDMA: 

EQU 

ODOH 

;DCH  AND  DMA  CONTROL  PORT 

MSINTO : 

EQU 

OEOH 

; MASTER  INTERRUPT 
; CONTROLLER  -  AO  =  0 

MSINT1 : 

EQU 

OE1H 

; MASTER  INTERRUPT 
; CONTROLLER  -  AO  =  1 

SLINTO: 

EQU 

0E2H 

; SLAVE  INTERRUPT 
; CONTROLLER  -  AO  =  0 

SLINT1 : 

EQU 

OE3H 

; SLAVE  INTERRUPT 
; CONTROLLER  -  AO  =  1 

TIMDAT : 

EQU 

0E4H 

;TIMING  CONTROLLER  DATA 

TIMCTL : 

EQU 

OE5H 

; TIMING  CONTROLLER  CONTROL 
; AND  STATUS  PORT 

SERDAT: 

EQU 

OE6H 

; CPU  SUPPORT  CARD 
; SERIAL  DATA  PORT 

SERCTL : 

EQU 

0E7H 

;  CPU  SUPPORT  CARD 
; SERIAL  CONTROL  AND  STATUS 

PRLDAT : 

EQU 

OE8H 

; CPU  SUPPORT  CARD 
; PARALLEL  DATA  PORT 

PRLCTL: 

EQU 

0E8H 

; CPU  SUPPORT  CARD 
; PARALLEL  STATUS  PORT 

DTABHI : 

EQU 

OFOH 

D/A  DATA  HI  BYTE  PORT 

DTABLO : 

EQU 

OF  1  H 

D/A  DATA  LO  BYTE  PORT 

DTACHI : 

EQU 

0F2H 

; # 1  D/A  DATA  HI  BYTE  PORT 

DTACLO : 

EQU 

OF3H 

;#1  D/A  DATA  LO  BYTE  PORT 

DTADHI : 

EQU 

0F4H 

; #2  D/A  DATA  HI  BYTE  PORT 

DTADLO : 

EQU 

0F5H 

; #2  D/A  DATA  LO  BYTE  PORT 

DTAAHI : 

EQU 

OF6H 

;03  D/A  DATA  HI  BYTE  PORT 

DTAALO : 

EQU 

OF7H 

; #3  D/A  DATA  LO  BYTE  PORT 

ATDSEL : 

EQU 

OF8H 

;  A/D  INPUT  SELECT  PORT 

ATDCVT: 

EQU 

OF9H 

; A/D  CONVERSION  START  PORT 

ATDSTS : 

EQU 

OF9H 

;  A/D  END  OF  CONVERSION  PORT 

ATDLO : 

EQU 

OFAH 

; A/D  CONVERTOR  LO  BYTE  PORT 

ATDHI : 

EQU 

OFBH 

; A/D  CONVERTOR  HI  BYTE  PORT 

THE  FOLLOWING  LITERAL  ASSIGNMENTS  SUPPLY  THE 
MNEUMONIC  CONSTANTS  USED  THROUGHOUT  CHOPS. 


MODEO : 

EQU 

OOOH 

;  MASK 

FOR 

SETTING 

MODE 

"00” 

MODE1  : 

EQU 

0 1 0H 

;  MASK 

FOR 

SETTING 

MODE 

"01” 

M0DE2 : 

EQU 

020H 

;  MASK 

FOR 

SETTING 

MODE 

"10" 

MODE3: 

EQU 

030H 

;  MASK 

FOR 

SETTING 

MODE 

"11" 

ERRBIT:  EQU 


OCOH 


MASK  FOR  SETTING  COMMAND 
COMPLETION  AND  ERROR  BITS 


CTON : 

EQU 

OCOH 

; CONTROL  CODE  FOR  CROMEMCO 
; TO  NOVA  DCH 

NTOC : 

EQU 

080H 

{CONTROL  CODE  FOR  NOVA 
{TO  CROMEMCO  DCH 

ERR1 : 

EQU 

OIH 

{ERROR  CODE  - 
;»NOT  A  COMMAND' 

ERR2 : 

EQU 

02H 

{ERROR  CODE  - 
{'INVALID  COMMAND' 

ERR3: 

EQU 

03H 

{ERROR  CODE  - 

{'INVALID  PARAMETER  COUNT' 

ERR4: 

EQU 

04H 

{ERROR  CODE  - 
{'PARAMETER  EXPECTED' 

ERR5: 

EQU 

05H 

{ERROR  CODE  - 
{'PARAMETER  OUT  OF  RANGE' 

ERR6: 

EQU 

06H 

{ERROR  CODE  - 
{•INVALID  COMMAND  MODE' 

ERR7: 

EQU 

07H 

{ERROR  CODE  - 

{'DATA  COMMAND  EXPECTED' 

ERR8: 

EQU 

08H 

{ERROR  CODE  - 
{•DATA  BUFFER  SIZE 
;  EXCEEDED* 

ERR9: 

EQU 

09H 

{ERROR  CODE  - 
{•DATA  OUT  OF  RANGE* 

ERRIO: 

EQU 

OAH 

{ERROR  CODE  - 
; 'REQUESTED  DEVICE 
;  OFF-LINE' 

LF: 

EQU 

OAH 

{LINE  FEED  ASCII  CODE 

CR: 

EQU 

ODH 

{CARRIAGE  RETURN  ASCII  CODE 

ODTCMO 

EQU 

OFFOOH 

{MODE  OUTPUT  DATA  COMMAND 
{WITHOUT  MODE  OR  ERROR  &  S=0 

ODTCM1 

EQU 

OFF  40H 

{OUTPUT  DATA  COMMAND 
{WITHOUT  MODE  OR  ERROR  &  S=1 

IDTCMO 

EQU 

0FF80H 

{INPUT  DATA  COMMAND 
{WITHOUT  MODE  OR  ERROR  &  S=0 

IDTCM1 

EQU 

OFFCOH 

{INPUT  DATA  COMMAND 
{WITHOUT  MODE  OR  ERROR  &  S=1 

DTCMO 

EQU 

OFFOOH 

{DATA  COMMAND  WITHOUT 
{MODE  OR  ERROR  &  S=0 

DTCM1 

9 

EQU 

0FF40H 

{DATA  COMMAND  WITHOUT 
{MODE  OR  ERROR  &  S=1 

• 

9 

9 

THE 

FOLLOWING  ADDRESS 

ASSIGNMENTS  ARE  USED  BY  CHOPS 

• 

9 

TO 

COMMUNICATE  WITH 

EXTERNAL  SYSTEM  ROUTINES. 

CDOS: 

EQU 

OOOOOH 

;CDOS  WARM  ENTRY  POINT 

CDSSYS : 

EQU 

00005H 

;CDOS  SYSTEM  ENTRY  POINT 

STACK: 

EQU 

OOIOOH 

{ABSOLUTE  TOP  OF  STACK 

ORG 


00100H 


THIS  RAM  BASED  VERSION  HAS  THE  FOLLOWING  ENTRY 
POINT  JUMP  VECTORS. 


BEGIN: 

OUT 

JP 

( 040H) , 
INIT 

A 

; TURN  OFF  RDOS  ROM 
; CHOPS  COLD  START 
;  ENTRY  POINT 

• 

9 

OUT 

JP 

(OHOH) , 
START 

A 

; TURN  OFF  RDOS  ROM 
; CHOPS  WARM  START 
;  ENTRY  POINT 

I 

• 

1 

REGARDLESS  OF  WHETHER 

CHOPS  RESIDES  IN  RAM  OR  ROM 

9 

THE 

FOLLOWING 

VARIABLES  MUST  ALWAYS  RESIDE  IN  RAM. 

CURCOM 

DW 

OOOOOH 

; CURRENT  COMMAND  STORAGE 

CMTPTR 

DW 

OOOOOH 

; COMMAND  TABLE  POINTER 

CILPTR 

DW 

OOOOOH 

; COMMAND  INFO  LIST  POINTER 

CSTPTR 

DW 

OOOOOH 

; COMMAND  STATUS  POINTER 

PRMBPT 

DW 

OOOOOH 

; PARAMETER  BUFFER  POINTER 

BLKSIZ 

DW 

OOOOOH 

; DCH  BLOCK  SIZE  STORAGE 

DATSTR 

DW 

OOOOOH 

; ADDRESS  OF  FIRST  DATA  WORD 
; IN  THE  DATA  BUFFER 

DATEND 

DW 

OOOOOH 

; ADDRESS  OF  LAST  DATA  WORD 
;  IN  THE  DATA  BUFFER 

DATTST 

DW 

OOOOOH 

; ADDRESS  OF  CURRENT  DATA 
;BUFFER  END 

LOMEM: 

DW 

01000H 

; LOWEST  ADDRESS  AVAILABLE 
; FOR  DATA  STORAGE 

HIMEM: 

DW 

OBFFFH 

; HIGHEST  ADDRESS  AVAILABLE 
;FOR  DATA  STORAGE 

JOBADR 

DW 

OOOOOH 

; ADDRESS  OF  CURRENT  JOB 

;  THE  FOLLOWING  BUFFER  IS  SET  ASIDE  FOR  THE  STORAGE 
;  OF  FLAGS  TO  INDICATE  THE  STATUS  OF  EACH  COMMAND. 

;  THESE  FLAGS  WILL  BE  REQUIRED  BY  CHOPS  WHEN  IT  IS 

;  FURTHER  ENHANCED  TO  PROVIDE  MULTI-TASKING. 

CMSTAT:  DS  001 OOH  ; COMMAND  STATUS  BUFFER  - 

; ROOM  FOR  256  COMMANDS 


;  THE  FOLLOWING  BUFFER  IS  USED  BY  CHOPS  TO  STORE  THE 

;  PARAMETERS  ASSOCIATED  WITH  EACH  COMMAND. 

PRMBUF :  DS  020H  ; PARAMETER  BUFFER  - 

; ROOM  FOR  16  WORDS 
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;  THE  FOLLOWING  RAM  SPACE  IS  SET  ASIDE  FOR  USE  BY 

;  TASKS.  THIS  AREA  CAN  BE  USED  BY  A  TASK  FOR 

;  RELOCATABLE  SERVICE  ROUTINES  OR  GENERAL  TASK 

;  VARIABLE  STORAGE. 

• 

USERAM:  DS  00300H-$  ;THIS  MUCH  RAM  FOR  TASK  USE 


9 

*****  ALL 

CODE  FROM  HERE 

ON  CAN  BE  PLACED  IN  ROM  *•**» 

> 

miHHO 

9 

9 

THIS  IS 

THE  ACTUAL  STARTING  LOCATION  OF  THE  CHOPS 

9 

ORG 

00300H 

{CHOPS  OBJECT  CODE  START 

9 

5 

THE  FOLLOWING  SEQUENCE 

OF  INSTRUCTIONS  SETS  UP 

9 

CHOPS 

ON  A  COLD  START 

• 

INIT: 

LD 

SP, STACK 

{INITIALIZE  STACK  POINTER 

CALL 

SETSER 

{INITIALIZE  SERIAL  PORT 
;IN  THIS  CASE  THE  EXTERNAL 
{TERMINAL.  ULTIMATELY,  FOR 
{THE  SERIAL  LINK  TO  THE 
{DEVELOPMENT  SYSTEM. 

LD 

HL, COMTBL 

{GET  DEFAULT  COMMAND 
{TABLE  ADDRESS 

LD 

( CMTPTR) , HL 

{SET  COMMAND  TABLE  POINTER 

LD 

HL , CMSTAT 

{CLEAR  COMMAND  STATUS  BUFFER 

XOR 

A 

{ZERO  "A"  REGISTER 

LD 

B,  A 

{ZERO  "B"  REGISTER 

ILOOP 

:  LD 

( HL)  ,  A 

{STORE  ZERO  FOR  ALL  TASKS 

INC 

HL 

{STATUS  TO  SET  TO 

DJNZ 

ILOOP 

{INACTIVE  STATE 

COMMAND/PARAMETER  COLLECTION  AND  VALIDATION  ROUTINE 

THE  FOLLOWING  PORTION  OF  THE  OPERATING  SYSTEM  IS 
RESPONSIBLE  FOR  COLLECTING  AND  VALIDATING  COMMANDS 
AND  PARAMETERS  THAT  ARE  SENT  FROM  THE  NOVA.  THIS 
SECTION  INSURES  THAT  THE  NOVA  STRICTLY  ADHERES  TO 
THE  I/O  CHANNEL  PROTOCOL  FOR  COMMAND  AND  PARAMETER 
COMMUNICATION. 


START:  CALL 

RDNOVA 

{CHECK  FOR  NOVA  COMMAND 

JR 

C , NOV  COM 

{TAKEN  TO  SERVICE  COMMAND 
{FROM  NOVA 

CALL 

RDSERI 

{CHECK  FOR  ACTIVITY  AT 
{THE  SERIAL  PORT 

JR 

Z, START 

{TAKEN  IF  NO  COMMAND 
{DETECTED  AT  SERIAL  PORT 

OR 

A 

{CLEAR  AC  BEFORE 
{ENTERING  CDOS 
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JP 

• 

CDOS 

; TAKEN  TO  SERVICE  SERIAL 
; COMMAND.  NOW  MERELY  AN 
; EXIT  TO  CDOS.  UTIMATELY 
; A  DEVELOPMENT  STATION 
; SERVICE  ROUTINE  SHOULD 
;BE  INVOKED  AS  THE  RESULT 
; OF  A  SERIAL  COMMAND. 

NOVCOM:  LD 

A,B 

;GET  COMMAND  ID 

AND 

OFFH 

; SET  CONDITION  CODES 

JP 

M, ACTCOM 

; TAKEN  IF  VALID 
; COMMAND  ID  (MSB=1) 

LD 

BC,OFFC1H 

; LOAD  ECHO  COMMAND  WITH 
;  "NOT  A  COMMAND’'  ERROR  CODE 

JP 

• 

ERROR1 

; TAKEN  TO  HANDLE  ERROR 

ACTCOM :  LD 

(CURCOM) ,BC 

{SAVE  ALTERED  COMMAND  WORD 

RLC 

C 

;  PUT  DIRECTION  BIT  IN  CARRY 

RL 

B 

;GET  DIRECTION  AS  LSB 
;OF  COMMAND 

RRC 

C 

; RESTORE  THE  LSB  OF  THE  LO 
;BYTE  OF  THE  COMMAND 

LD 

HL, (CMTPTR) 

; POINT  TO  BASE  ADDRESS  OF 
; COMMAND  INFO  LIST  (CIL) 

; POINTER  TABLE 

LD 

E,B 

; USE  COMMAND  FOR  OFFEST 
;  INTO  COMMAND  TABLE 

LD 

D,  OOH 

;ZERO  HI  BYTE  OF  OFFSET 

SLA 

E 

; MULTIPLY  LO  BYTE  BY  TWO 

RL 

D 

; PICK  UP  CARRY  IN  HI  BYTE 

ADD 

HL.DE 

; POINT  TO  THIS  COMMAND’S 
; CIL  POINTER 

LD 

E,  ( HL) 

{GET  LO  BYTE  OF  CIL  ADDRESS 

INC 

HL 

; HL  NOW  POINTS  TO  ADDRESS 
;  HI  BYTE 

LD 

D,(HL) 

; DE  POINTS  TO  CIL 

LD 

(CILPTR) ,DE 

; SAVE  CIL  POINTER 

LD 

A,  D 

;GET  HI  BYTE  OF 
{ADDRESS  OF  CIL 

AND 

OFFH 

; SET  CONDITION  CODES 

JR 

NZ, VALCOM 

; TAKEN  IF  COMMAND  IS  VALID 
;  HI  BYTE  IS  NON  ZERO 

LD 

D, ERRBIT 

;GET  MASK  FOR  SETTING  ERROR 

LD 

E, ERR2 

;GET  INVALID  COMMAND  CODE 

JP 

• 

ERR0R2 

; TAKEN  TO  HANDLE  ERROR 

VALCOM:  EX 

DE,  HL 

;HL  GETS  CIL  POINTER 

LD 

A , ( HL) 

;GET  PARAMETER  COUNT 
;  FROM  CIL 

AND 

OFH 

; MASK  TO  LOWER  FOUR  BITS 

LD 

B,  A 

; SAVE  COUNT  FROM  LIST 

LD 

A,C 

;GET  LO  BYTE  OF  COMMAND 

AND 

OFH 

; MASK  TO  LOWER  FOUR  BITS 

CP 

B 

;TEST  FOR  MATCHING  P  COUNT 

INC 

HL 

;BUMP  CIL  POINTER 

JR 

Z, PCNTOK 

; TAKEN  IF  P  COUNTS  ARE  O.K. 

LD 

E, ERR3 

;GET  ERROR  CODE  FOR 
; "INVALID  PARAMETER  COUNT" 

• 

JP 

ERROR 

; TAKEN  TO  SEND  ERROR  TO  NOVA 

PCNTOK: 

LD 

E,(HL) 

;GET  LO  BYTE  OF  COMMAND 
; STATUS  LOCATION  FROM  CIL 

INC 

HL 

; BUMP  CIL  POINTER 

LD 

D, ( HL) 

;GET  HI  BYTE  OF  COMMAND 
; STATUS  LOCATION  FROM  CIL 

INC 

HL 

; BUMP  CIL  POINTER 

LD 

(CSTPTR) ,DE 

; SAVE  COMMAND  STATUS  POINTER 

OR 

0  80H 

; SET  STATUS  BIT  TO  ACTIVE 

LD 

(DE) , A 

; SAVE  ACTIVE  COMMAND  STATUS 
; WITH  PARAMETER  COUNT 

LD 

BC, PRMBUF 

;GET  PARAMETER  BUFFER  ADDRESS 

LD 

( PRMBPT) ,BC 

; SET  BUFFER  POINTER  TO  TOP 
; OF  BUFFER 

LD 

BC , ( CURCOM) 

;GET  CURRENT  COMMAND 

RES 

7,C 

; CLEAR  ERROR  FLAG  OF  LO  BYTE 
;OF  COMMAND  WORD 

CALL 

WRNOVA 

; ECHO  COMMAND  TO  NOVA 

LD 

A,  C 

;GET  LO  BYTE  OF 
{CURRENT  COMMAND 

AND 

030H 

{KEEP  ONLY  THE  COMMAND  MODE 

JR 

Z, ZMODE 

{TAKEN  FOR  MODE  "00" 

CP 

030H 

{CHECK  FOR  MODE  "11" 

JR 

NZ, INPRAM 

{TAKEN  FOR  NON  MODE  "11" 

;T0  GET  THE  EXTRA  PARAMETER 

ZMODE : 

PUSH 

HL 

{SAVE  THE  CURRENT  CIL  POINTER 

LD 

HL, (CILPTR) 

{SET  POINTER  TO  THE  TOP  OF 
{THE  CIL  FOR  THIS  COMMAND 

LD 

A, ( HL) 

{GET  THE  PARAMETER  COUNT  BYTE 

POP 

HL 

{RESTORE  ORIGINAL  CIL  POINTER 

AND 

OIOH 

{MASK  ALL  BUT  EXTRA 
{PARAMETER  BIT 

JR 

INC 

INC 

INC 

Z , TSTPRM 

HL 

HL 

HL 

{TAKEN  FOR  COMMANDS  NOT 
{UTILIZING  EXTRA  PARAMETER 

INC 

HL 

{ADJUST  CIL  POINTER  TO  BYPASS 
{THE  EXTRA  PARAMETER  BOUNDS 

PUSH 

HL 

{SAVE  CIL  POINTER 

LD 

HL, PRMBPT 

{GET  PARAMETER  BUFFER  POINTER 

INC 

(HL) 

{ADJUST  BUFFER  POINTER  TO  SKIP 

INC 

(HL) 

{FIRST  PARAMETER  STORAGE 

POP 

HL 

{RESTORE  CIL  POINTER 

• 

JR 

TSTPRM 

{TAKEN  TO  CHECK  FOR 
{PARAMETER  COLLECTION 

PRAMLP: 

DEC 

A 

{DECREASE  PARAMETER  COUNT 

PUSH 

AF 

{SAVE  PARAMETER  COUNT 
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LD 

A,C 

AND 

OFOH 

LD 

C,  A 

POP 

AF 

OR 

C 

LD 

C ,  A 

INPRAM:  PUSH 

BC 

GETPRM :  CALL 

RDNOVA 

JR 

NC, GETPRM 

LD 

A,B 

OR 

A 

JP 

P, CHKPRM 

LD 

E, ERR4 

JR 

PRMERR 

• 

CHKPRM :  CALL 

BNDTST 

JR 

C, PRLOOK 

PRBERR :  LD 

E, ERR5 

PRMERR :  POP 

BC 

JR 

ERROR 

• 

PRLOOK :  INC 

HL 

INC 

HL 

CALL 

BNDTST 

JR 

C, PRBERR 

PRAMOK:  INC 

HL 

INC 

HL 

PUSH 

HL 

LD 

HL , ( PRMBPT ) 

LD 

( HL)  ,  C 

INC 

HL 

LD 

(HL)  ,B 

INC 

HL 

LD 

(PRMBPT) ,  HL 

POP 

HL 

POP 

BC 

CALL 

WRNOVA 

TSTPRM :  LD 

A ,  C 

AND 

OFH 

JR 

NZ , PRAMLP 

NOPRAM:  PUSH 

DE 

GET  LO  BYTE  OF  COMMAND  WORD 
MASK  OUT  PARAMETER  COUNT 
SET  COMMAND  LOW  BYTE 
WITH  NULL  PARAMETER  FIELD 
RESTORE  DECREMENTED 
PARAMETER  COUNT 
PUT  NEW  PARAMETER  COUNT  INTO 
PARAMETER  COUNT  FIELD 
SAVE  COMMAND  TO  ECHO  TO  NOVA 
GET  A  PARAMETER  FROM  NOVA 
TAKEN  TO  WAIT  FOR  PARAMETER 
GET  HI  BYTE  OF  PARAMETER 
SET  CONDITION  CODES 
TAKEN  IF  VALID  PARAMETER 
WORD  -  (MSB  IS  ZERO) 

GET  ' PARAMETER  EXPECTED' 

ERROR  CODE 

TAKEN  TO  RESPOND  TO 

ERROR  CONDITION 

CHECK  PARAMETER  AGAINST 
CIL  LO  BOUND 
TAKEN  IF  PARAMETER  IS 
GREATER  THAN  ITS  LOW  BOUND 
GET  ERROR  CODE  FOR 
'PARAMETER  OUT  OF  BOUNDS' 
RESTORE  THE  SAVED  COMMAND 
TO  ADJUST  STACK 
TAKEN  TO  RESPOND  TO 
ERROR  CONDITION 

BUMP  CIL  POINTER  TO 
POINT  TO  HI  PARAMETER  BOUND 
CHECK  PARAMETER  AGAINST  CIL 
HI  BOUND 

TAKEN  IF  PARAMETER  IS 
GREATER  THAN  ITS  HIGH  BOUND 
BUMP  CIL  POINTER  TO 
POINT  TO  NEXT  CIL  ENTRY 
SAVE  CIL  POINTER 
GET  PARAMETER  BUFFER  POINTER 
SAVE  LO  BYTE  OF  PARAMETER 
BUMP  PARAMETER  BUFFER  POINTER 
SAVE  HI  BYTE  OF  PARAMETER 
BUMP  PARAMETER  BUFFER  POINTER 
SAVE  PARAMETER  BUFFER  POINTER 
RESTORE  CIL  POINTER 
RESTORE  COMMAND  TO  BE  ECHOED 
SEND  ECHO  COMMAND  TO  NOVA 
GET  LO  BYTE  OF  CURRENT  COMMAND 
KEEP  ONLY  THE  PARAMETER  COUNT 
TAKEN  TO  COLLECT  ANOTHER 
PARAMETER  WORD 
SAVE  COMMAND  STATUS  POINTER 
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LD 

E ,  (  HL) 

INC 

HL 

LD 

D, ( HL) 

EX 

DE,  HL 

LD 

A ,  C 

AND 

030H 

SRA 

A 

SRA 

A 

SRA 

A 

LD 

E,  A 

LD 

D ,  OOH 

ADD 

HL ,  DE 

POP 

DE 

LD 

A,  (DE) 

JP 

(HL) 

GET  LO  BYTE  OF  TASK  ADDRESS 

BUMP  CIL  POINTER 

GET  HI  BYTE  OF  TASK  ADDRESS 

SAVE  TASK  ADDRESS  IN  HL 

GET  LO  BYTE  OF 

CURRENT  COMMAND 

EXTRACT  COMMAND  MODE 

RIGHT  JUSTIFY  MODE  AND 

MULTIPLY  MODE  BY  TWO 

FOR  TASK  ENTRY  OFFSET 

FORM  LO  BYTE  OF  OFFSET 

ZERO  THE  OFFSET  HI  BYTE 

FORM  TASK  ENTRY  POINT  IN  HL 

RESTORE  COMMAND  STATUS  POINTER 

GET  CURRENT  COMMAND  STATUS 

TAKEN  TO  PASS  CONTROL  TO 

THE  REQUESTED  TASK 


TASK  COMPLETION/ERROR  HANDLING  ROUTINE 


THE  FOLLOWING  PORTION  OF  THE  OPERATING  SYSTEM 
PROVIDES  THE  CAPABLITY  OF  COMMUNICATING  THE 
COMPLETION  OF  A  TASK  OR  ERRORS  THAT  OCCUR  TO  THE 
NOVA.  THE  ERROR  HANDLING  ROUTINES  PASS  THE  NOVA 
THE  ERROR  CODES  THAT  ARE  PASSED  IN  THE  ' E'  REGISTER. 
THESE  ROUTINES  THEN  INVOKE  THE  TASK  TERMINATION 
ROUTINE.  THIS  ROUTINE  PROVIDES  FOR  THE  ORDERLY 
TERMINATION  OF  THE  TASK  THAT  IS  CURRENTLY  ACTIVE. 
WHEN  THERE  IS  NO  ERROR  CONDITION,  THE  TASK 
TERMINATION  ROUTINE  IS  INVOKED  AT  THE  END  OF  THE 
COMMAND  SERVICE. 


TCMPLT :  LD 

DE , 04000H 

JR 

DACTCC 

ERROR:  LD 

D, ERRBIT 

DACTCC :  LD 

BC, (CURCOM) 

DACTIV:  LD 

HL , ( CSTPTR ) 

XOR 

A 

LD 

(HL)  ,A 

ERROR2 :  LD 

A,  C 

AND 

030H 

OR 

D 

OR 

E 

LD 

C,  A 

ERROR1 :  CALL 

WRNOVA 

LD 

A, 098H 

; SET  ONLY  TASK  COMPLETION 
; BIT  IN  ERROR  BYTES 
; TAKEN  TO  PERFORM  PROPER 
; COMMAND  COMPLETION 

;  SET  ERROR  BIT  CODE 

;GET  CURRENT  COMMAND 

;GET  COMMAND  STATUS  POINTER 

;ZERO  ACCUMULATOR 

;  SET  COMMAND  STATUS 

;  TO  INACTIVE 

;GET  LO  BYTE  OF  COMMAND 

;  EXTRACT  MODE  FIELD  ONLY 

;OVERLAY  ERROR/COMPLETION 

;  BITS 

;  OVERLAY  ERROR  CODE  FIELD 
;  REPLACE  LO  BYTE  OF  COMMAND 
; EC  HO  COMMAND  TO  NOVA 
; INSURE  THAT  DCH  IS  DISABLED 
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OUT 


(DCHDMA) , A  ; AND  THAT  DIRECTION  IS  SET 

; FOR  THE  CROMEMCO  TO  INPUT 
JP  START  ; TAKEN  TO  RESUME  SCAN  FOR 

; NEXT  COMMAND 


DATERR:  LD 

DE,[ERRBIT+M0DE1 

JR 

CMDERR 

DCHERR :  LD 

DE , [ ERRBIT+M0DE2 

JR 

CMDERR 

DCMERR :  POP 

DE 

LD 

E, ERR7 

CMDERR :  LD 

BC, DTCM1 

JR 

DACTIV 

DABORT:  PUSH 

DE 

LD 

DE , ( CURCOM) 

LD 

A,  C 

AND 

M0DE3 

CP 

M0DE3 

JR 

NZ, DCMERR 

LD 

A,  E 

AND 

OCFH 

LD 

E,  A 

LD 

A,  C 

AND 

OCFH 

CP 

E 

JR 

NZ, DCMERR 

LD 

A ,  B 

CP 

D 

JR 

NZ, DCMERR 

POP 

DE 

JP 

ACTCOM 

]*256+ERR8  ;GET  MODE  "01" 
{ERROR  BYTES 

{TAKEN  TO  SERVICE  A  DATA 
{COMMAND  ERROR 

]  *256  +ERR8  {GET  MODE  "10" 
{ERROR  BYTES 

{TAKEN  TO  SERVICE  A  DATA 
{COMMAND  ERROR 

{RESTORE  ERROR  BYTES 

{GET  ‘DATA  COMMAND  EXPECTED' 

{ERROR  CODE 

{GET  DATA  COMMAND  WITH  S=1 
{TAKEN  TO  HANDLE  ERROR 
{DURING  DATA  COMMAND 

{SAVE  ERROR  BYTES 

{GET  CURRENT  COMMAND 

{GET  LO  BYTE  OF  POSSIBLE 

{RECEIVED  COMMAND 

{MASK  OUT  THE  MODE  OF 

{POSSIBLE  COMMAND 

{TEST  FOR  ABORT  COMMAND 

{TAKEN  WHEN  DATA  COMMAND 

{ERROR  DETECTED 

{GET  LO  BYTE  OF 

{CURRENT  COMMAND 

{MASK  OFF  MODE  FIELD 

{REPLACE  LO  BYTE  OF 

{CURRENT  COMMAND 

{GET  RECEIVED  WORD  LO  BYTE 

{MASK  OFF  MODE  FIELD 

{CHECK  FOR  MATCH 

{TAKEN  IF  NOT  ABORT  COMMAND 

{GET  RECEIVED  WORD  HI  BYTE 

{CHECK  AGAINST  CURRENT 

{COMMAND  HI  BYTE 

{TAKEN  IF  TASK  FIELDS 

;D0  NOT  COMPARE 

{RESTORE  ERROR  BYTES 

{TAKEN  TO  SERVICE 

{ABORT  COMMAND 


DATA  TRANSFER  PROTOCOL  HANDLING  ROUTINES 


DOJOBI: 


DOJOBO: 


THE  FOLLOWING  PORTION  OF  THE  OPERATING  SYSTEM 
PROVIDES  THE  ROUTINES  FOR  PASSING  DATA  TO  AND 
FROM  THE  NOVA.  THESE  ROUTINES  RELIEVE  THE  TASKS 
AND,  CONSEQUENTLY,  ONE  WHO  MUST  WRITE  A  TASK  OF 
THE  REQUIREMENT  OF  DETAILED  KNOWLEDGE  OF  THE 
CHANNEL  PROTOCOL. 

TASKS  NORMALLY  ENTER  THIS  CODE  AT  'DOJOBI*  FOR  JOBS 
THAT  ARE  TO  RECEIVE  DATA  FROM  THE  NOVA  AND  AT 
'DOJOBO*  FOR  JOBS  THAT  ARE  TO  SEND  DATA  TO  THE  NOVA. 
IN  EITHER  CASE  THE  ENTRY  IS  MADE  VIA  AN  ABSOLUTE 
JUMP  TO  THE  ADDRESS  OF  THE  ENTRY  POINT  WITH  THE  'HL' 
REGISTER  SET  TO  THE  ADDRESS  OF  THE  JOB  THAT  IS  TO 
BE  INVOKED  AND  THE  *  DE'  REGISTER  SET  TO  THE  ADDRESS 
OF  THE  DATA  HANDLER  THAT  IS  TO  BE  USED  TO  TRANSFER 
THE  DATA. 

FOUR  DATA  HANDLERS  ARE  AVAILABLE: 

' DATINP •  -  TRANSFERS  FROM  THE  NOVA  VIA  MODE  "01" 
'DATOUT'  -  TRANSFERS  TO  THE  NOVA  VIA  MODE  "01 " 

' DCHINP'  -  TRANSFERS  FROM  THE  NOVA  VIA  MODE  "10” 

' DCHOUT '  -  TRANSFERS  TO  THE  NOVA  VIA  MODE  "10" 

TASKS  MUST  INSURE  THAT  THE  PROPER  LINKAGE  ADDRESSES 
ARE  GENERATED  BEFORE  ENTERING  THIS  CODE.  THE 
ADDRESSES  OF  'DOJOBI',  'DOJOBO',  'DATOUT',  'DATINP', 
•DCHOUT',  AND  'DCHINP'  HAVE  BEEN  DEFINED  AS  ENTRY 
ADDRESSES;  THEREFORE,  TASKS  MERELY  HAVE  TO  SPECIFY 
THESE  ADDRESSES  AS  EXTERNAL  TO  USE  THEM.  THE  SYSTEM 
LINKER  WILL  THEN  RESOLVE  THE  FINAL  ADDRESSES  AT  LINK 
TIME. 


LD 

(JOBADR) ,HL 

SAVE  JOB  ADDRESS 

LD 

HL, (DATEND) 

GET  ADDRESS  OF  DATA 

BUFFER  END 

LD 

( DATTST) , HL 

SET  UP  DATA  TRANSFER 

TEST  ADDRESS 

JR 

CONTJB 

TAKEN  TO  CONTINUE  TASK 
SERVICE 

PUSH 

DE 

SAVE  DATA  HANDLER  ADDRESS 

CALL 

DOJOB 

INVOKE  THE  JOB  ROUTINE 

POP 

DE 

RESTORE  ADDRESS  OF  DATA 
HANDLER 

JR 

C, ERROR 

TAKEN  IF  ERROR  OCCURRED 
DURING  JOB  EXECUTION 

LD 

HL, (DATEND) 

GET  ADDRESS  OF  LAST  DATA 
WORD  IN  BUFFER 

LD 

(DATTST) ,HL 

SET  UP  DATA  TRANSFER 

TEST  ADDRESS 

100 


CONTJB : 

EX 

DE,  HL 

; PUT  DATA  HANDLER  ADDRESS 
; IN  HL  REGISTER 

DOJOB: 

» 

JP 

(HL) 

; INVOKE  DATA  HANDLER  OR 
; CURRENT  JOB 

DATOUT: 

CALL 

SETBUF 

; SET  DATA  WORD  COUNT  AND 
; POINTER  TO  DATA  BUFFER 

PUTDAT: 

PUSH 

DE 

; SAVE  DATA  WORD  COUNT 

LD 

DE , ODTCMO+MODE1 

; SET  UP  TO  WAIT  FOR  MODE 
; "01 "  OUTPUT  DATA  COMMAND 
; WITH  S=0 

CALL 

GETDCM 

;GET  COMMAND  FROM  NOVA 

JR 

Z, ODCOK 

; TAKEN  IF  VALID  DATA 
{COMMAND  RECEIVED 

POP 

DE 

{POP  STACK  FOR  ERROR  EXIT 

LD 

D, ERRBIT+MODE1 

{SET  UP  ERROR  BYTE 

JR 

DABORT 

{TAKEN  TO  TEST  FOR 
{ABORT  COMMAND 

ODCOK : 

LD 

BC , DTCMO+MODE 1 

{SET  UP  TO  ECHO  MODE  "01" 
{DATA  COMMAND  WITH  S=0 

POP 

DE 

{GET  WORD  COUNT 

LD 

A ,  D 

{GET  WORD  COUNT  HI  BYTE 

OR 

A 

{SET  CONDITION  CODES 

JR 

NZ, PUTNXT 

{TAKEN  IF  HI  BYTE  NOT  ZERO 

LD 

A,  E 

{GET  WORD  COUNT  LO  BYTE 

CP 

0 1  H 

{CHECK  FOR  LAST  WORD 

JR 

NZ, PUTNXT 

{TAKEN  IF  NOT  LAST  WORD 

SET 

6  ,C 

{SET  COMMAND  COMPLETION  BIT 

PUTNXT : 

CALL 

WRNOVA 

{ECHO  COMMAND  TO  NOVA 

CALL 

TSTDON 

{WAIT  FOR  CLEARED  DONE  FLAG 

CALL 

RDNOVA 

{CHECK  FOR  COMMAND  FROM  NOVA 

JR 

NC , PUTDT 

{TAKEN  IF  NO  NEW  COMMAND 

LD 

D, ERRBIT+MODE1 

{SET  UP  ERROR  BYTE 

JR 

DABORT 

{TAKEN  TO  TEST  FOR 
{ABORT  COMMAND 

PUTDT : 

CALL 

OUTDAT 

{SEND  DATA  WORD  TO  NOVA 

CALL 

DBETST 

{TEST  FOR  DATA  BUFFER  END 

JP 

C , DATERR 

{TAKEN  IF  DATA  BUFFER  HAS 
{OVERFLOWED 

DEC 

DE 

{DECREASE  WORD  COUNT 

LD 

A ,  E 

{GET  LOW  BYTE  OF  WORD  COUNT 

OR 

A 

{SET  CONDITION  CODES 

JR 

NZ, PUTDAT 

{TAKEN  IF  MORE  DATA  TO  SEND 

CP 

D 

{TEST  FOR  ZERO  DATA  COUNT 

JR 

NZ, PUTDAT 

{TAKEN  TO  SEND  MORE  DATA 

> 

JP 

TCMPLT 

{TAKEN  TO  WRAP  UP  COMMAND 

DCHOUT : 

LD 

DE,ODTCMO+MODE2 

{SET  UP  TO  WAIT  FOR  MODE 
;”10"  OUTPUT  DATA  COMMAND 

CALL 

GETDCM 

{GET  NOVA  DATA  COMMAND 

JR 

NZ, ODCHEX 

TAKEN  IF  DATA  COMMAND 

NOT  RECEIVED 

LD 

BC , DTCM0+M0DE2 

SET  UP  TO  ECHO  MODE  "10" 
DATA  COMMAND  WITH  S=0 

SET 

6 ,  E 

SET  COMMAND  COMPLETION 

BIT  OF  COMMAND  LO  BYTE 

CALL 

CMDTST 

ECHO  DATA  COMMAND 

JR 

NC, ODCHGO 

TAKEN  IF  NOVA  HAS  NOT 

SENT  A  NEW  COMMAND 

JR 

ODCHEX 

TAKEN  TO  EXIT  DCH  TRANSFER 
AND  TEST  FOR  ABORT  COMMAND 

ODCHGO : 

LD 

A , CTON 

GET  CONTROL  CODE  FOR 
CROMEMCO  TO  NOVA 

CALL 

DCHSET 

SET  DCH  CONTROL  BYTE 

OTBCNT : 

LD 

DE , ( BLKSI Z ) 

GET  DCH  BLOCK  SIZE 

NUMBER  OF  512  BYTE  NCVA 

DISK  BLOCKS 

LD 

C , DCHLO 

GET  PORT  ADDRESS  OF  DCH 

LO  BYTE 

OTDCNT : 

LD 

B,  OOH 

ZERO  DCH  WORD  COUNTER 

CALL 

DBETST 

CHECK  FOR  DATA  BUFFER  END 

JP 

C , DCHERR 

TAKEN  IF  PASSED  END  OF 

DATA  BUFFER 

ODCHLP : 

CALL 

OUTDCH 

SEND  A  WORD  VIA  DCH 

JP 

NZ, ODCHLP 

CONTINUE  FOR  256  WORDS 

DEC 

E 

DECREASE  DCH  BLOCK  COUNT 

JP 

NZ , OTDCNT 

TAKEN  TO  GET  NEXT  BLOCK 

LD 

DE, ODTCM1 +M0DE2 

SET  TEST  FOR  MODE  "10"  DATA 
COMMAND  WITH  S=0 

LD 

BC , DTCMO+MODE2 

SET  MODE  "10"  DATA  COMMAND 

CALL 

CMDTST 

ECHO  DATA  COMMAND  TO  NOVA 

JP 

NC, OTBCNT 

TAKEN  IF  NEW  COMMAND  FROM 
NOVA  NOT  DETECTED 

ODCHEX : 

LD 

D, ERRBIT+M0DE2 

SET  ERROR  BYTE 

JP 

NZ , DABORT 

TAKEN  TO  TEST  FOR  ABORT 

LD 

BC , DTCM1 +M0DE2 

SET  MODE  "10"  DATA 

COMPLETE  COMMAND 

CALL 

WRNOVA 

ECHO  DATA  COMPLETE  COMMAND 

f 

JP 

TCMPLT 

TAKEN  TO  WRAP  UP  COMMAND 

DATINP : 

CALL 

SETBUF 

SET  DATA  WORD  COUNT  AND 
POINTER  TO  DATA  BUFFER 

GETDAT: 

PUSH 

DE 

SAVE  DATA  WORD  COUNT 

LD 

DE , IDTCMO+MODE1 

SET  UP  TO  WAIT  FOR  MODE 
"01"  DATA  COMMAND  WITH  S=0 

CALL 

GETDCM 

GET  COMMAND  FROM  NOVA 

JR 

Z , IDCOK 

TAKEN  IF  VALID  DATA 

COMMAND  RECEIVED 

POP 

DE 

POP  STACK  FOR  ERROR  EXIT 

LD 

D, ERRBIT+MODE1 

SET  UP  ERROR  BYTE 

IDCOK : 


GETNXT : 

J 

DCHINP : 


IDCHGO ; 

INBCNT : 

INDCNT : 


JP 

DABORT 

LD 

BC , DTCMO+MODE1 

CALL 

WRNOVA 

CALL 

INPDAT 

CALL 

DBETST 

JP 

C , DATERR 

LD 

BC, DTCMO+MODE1 

POP 

DE 

LD 

A,D 

OR 

A 

JR 

NZ, GETNXT 

LD 

A,  E 

CP 

0 1  H 

JR 

NZ, GETNXT 

SET 

6  ,C 

CALL 

WRNOVA 

DEC 

DE 

LD 

A,  E 

OR 

A 

JR 

NZ ,GETDAT 

CP 

D 

JR 

NZ ,GETDAT 

JR 

DOI JOB 

LD 

DE , IDTCMO+MODE2 

CALL 

JP 

GETDCM 

NZ , IDCHEX 

SET 

LD 

6 ,  E 

BC , DTCM0+M0DE2 

CALL 

JR 

CMDTST 

NC, IDCHGO 

JR 

IDCHEX 

LD 

A , NTOC 

CALL 

LD 

LD 

DCHSET 

DE , ( BLKSIZ ) 

C , DCHLO 

LD 

CALL 

B,  OOH 

DBETST 

; TAKEN  TO  CHECK  FOR 
; ABORT  COMMAND 

;  SET  UP  TO  ECHO  MODE  n01" 

; DATA  COMMAND  WITH  S=0 
; ECHO  COMMAND  TO  NOVA 
;GET  DATA  WORD  FROM  NOVA 
; TEST  FOR  BUFFER  END 
; TAKEN  IF  PASSED  END  OF 
;  DATA  BUFFER 

;  SET  UP  TO  ECHO  MODE  "01" 

;  DATA  COMMAND  WITH  S=0 
;GET  WORD  COUNT 
;GET  WORD  COUNT  HI  BYTE 
;  SET  CONDITION  CODES 
;  TAKEN  IF  HI  BYTE  NOT  ZERO 
;GET  WORD  COUNT  LO  BYTE 
;  TEST  FOR  LAST  DATA  WORD 
; TAKEN  IF  NOT  LAST  WORD 
;  SET  COMMAND  COMPLETION  BIT 
;  IN  LO  BYTE  OF  ECHO  COMMAND 
; ECHO  DATA  COMMAND  TO  NOVA 
{DECREASE  WORD  COUNT 
;GET  LO  BYTE  OF  WORD  COUNT 
; SET  CONDITION  CODES 
{TAKEN  IF  MORE  INPUT  DATA 
{TEST  FOR  ZERO  DATA  COUNT 
{TAKEN  TO  GET  MORE  DATA 
{TAKEN  TO  INVOKE  INPUT  JOB 


SET  UP  TO  WAIT  FOR  MODE 
"10"  OUTPUT  DATA  COMMAND 
GET  NOVA  DATA  COMMAND 
TAKEN  IF  DATA  COMMAND 
NOT  RECEIVED 

SET  COMMAND  COMPLETION  BIT 
SET  UP  TO  ECHO  MODE  "10" 
DATA  COMMAND  WITH  S=0 
ECHO  DATA  COMMAND 
TAKEN  IF  NOVA  HAS  NOT 
SENT  A  NEW  COMMAND 
TAKEN  TO  EXIT  DCH  TRANSFER 
AND  TEST  FOR  ABORT  COMMAND 

GET  CONTROL  CODE  FOR 
NOVA  TO  CROMEMCO 
SET  DCH  CONTROL  BYTE 
GET  DCH  BLOCK  SIZE 
SET  PORT  ADDRESS  FOR  DCH 
LO  BYTE 

SET  WORD  COUNTER  TO  ZERO 
CHECK  FOR  DATA  BUFFER  END 
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IDCHLP : 


IDCHEX : 


DOIJOB: 


JP 

C , DCHERR 

CALL 

JP 

INPDCH 

NZ, IDCHLP 

DEC 

JP 

E 

NZ, INDCNT 

LD 

LD 

CALL 

DE , IDTCM1 +MODE2 
BC , DTCM0+M0DE2 
CMDTST 

JP 

NC, INBCNT 

LD 

JP 

LD 

D, ERRBIT+MODE2 
NZ , DABORT 

BC , DTCM1 +MODE2 

CALL 

CALL 

CALL 

WRNOVA 

TSTDON 

RDNOVA 

LD 

D, ERRBIT 

JP 

C, DABORT 

LD 

LD 

CALL 

JP 

(DATEND) ,HL 

HL,( JOBADR) 
DOJOB 

C, ERROR 

JP 

TCMPLT 

TAKEN  IF  PASSED  END  OF 
DATA  BUFFER 

INPUT  VIA  DATA  CHANNEL 
TAKEN  TO  CONTINUE 
RECEIVING  DATA  BLOCK 
DECREMENT  DCH  BLOCK  COUNT 
TAKEN  TO  RECEIVE  NEXT 
PORTION  OF  DCH  BLOCK 
GET  EXPECTED  DATA  COMMAND 
GET  ECHO  DATA  COMMAND 
ECHO  DATA  COMMAND  AND  CHECK 
FOR  COMMAND  FROM  NOVA 
TAKEN  IF  NO  NEW  COMMAND 
FROM  NOVA 
SET  ERROR  BYTE 
TAKEN  TO  TEST  FOR  ABORT 
SET  MODE  "10”  DATA 
COMPLETE  COMMAND 
ECHO  DATA  COMPLETE  COMMAND 
WAIT  FOR  DONE  TO  CLEAR 
CHECK  FOR  NEW  COMMAND 
FROM  NOVA 

SET  ERROR  BYTE  IN  CASE  OF 
NEW  COMMAND 

TAKEN  IF  NEW  COMMAND  FROM 

NOVA  RECEIVED 

SAVE  DATA  BUFFER  POINTER 

GET  ADDRESS  OF  INPUT  JOB 

INVOKE  THE  COMMANDED  JOB 

TAKEN  IF  ERROR  DURING 

JOB  EXECUTION 

TAKEN  TO  WRAP  UP  COMMAND 


CHOPS  -  SUBROUTINES 

THE  FOLLOWING  SUBROUTINES  ARE  CALLED  FROM  VARIOUS 
PLACES  WITHIN  THE  OPERATING  SYSTEM.  SEVERAL  OF 
THESE  ROUTINES  HAVE  BEEN  MADE  GLOBAL  AND  THEREFORE, 
CAN  BE  USED  BY  TASKS.  USING  SOME  OF  THESE  ROUTINES 
SHOULD  SIMPLIFY  THE  WRITING  OF  ADDITIONAL  TASKS  FOR 
THE  CHOPS. 

CONSULT  ROUTINE  NAMES  IN  THE  ENTRY  STATEMENTS  AT 
THE  BEGINNING  OF  THIS  LISTING  FOR  THE  ROUTINES 
THAT  ARE  GLOBAL. 


THE  FOLLOWING  ROUTINE  WAS  INTENDED  TO  BE  RESPONSIBLE 
FOR  SETTING  UP  THE  HARDWARE  COMPOSING  THE  SERIAL 
LINK  TO  THE  DEVELOPMENT  STATION.  UNFORTUNATELY, 

THE  DEVELOPMENT  STATION  WAS  NOT  AVAILABLE  AT  THE 
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TIME  THAT  THIS  VERSION  OF  THE  CHOPS  WAS  PUBLISHED. 
HOPEFULLY,  A  FUTURE  VERSION  WILL  INCORPORATE  THIS 
CAPABILITY. 

THIS  ROUTINE  CURRENTLY  PRINTS  THE  'PROMPT'  MESSAGE 
TO  THE  SYSTEM  CONSOLE  CONNECTED  TO  THE  SYSTEM 
DURING  CHOPS  DEVELOPMENT. 


SETSER:  LD 
LD 
JP 


DE, PROMPT 

C,09H 

CDSSYS 


GET  ADDRESS  OF  PROMPT 
CDOS  PRINT  BUFFERED  LINE 
CDOS  SYSTEM  ENTRY  POINT 


PROMPT: 


RDSERI 


DB 

DB 

DB 

DB 

DB 

DB 

DB 

DB 

DB 


CR,  LF,  LF,  LF,  LF,  LF,  LF,  LF,  LF,  LF,  LF 
CHOP  S' , CR , LF 
IS  UP' ,CR , LF, LF, LF 
DEPRESSING  ANY  KEY  WILL  EXIT* , CR , LF , LF 
TO  RESTART  -• ,CR,LF 

IF  DISK  DRIVE  IS  CONNECTED », CR , LF 
TYPE  "CHOPS"/RETURN ' ,CR,LF 
OTHERWISE  -  PRESS  RESET/ RETURN ', CR ,  LF 
TYPE  "G 100 "/RETURN' , CR , LF, LF, LF, LF, LF,  '  $  ' 


THIS  ROUTINE  IS  RESPONSIBLE  FOR  TESTING  FOR  AND 
READING  DATA  ON  THE  SERIAL  DEVELOPMENT  STATION 
LINK.  AS  EXPLAINED  FOR  THE  ROUTINE  ABOVE  THE 
DEVELOPMENT  STATION  WAS  NOT  AVAILABLE  FOR  THIS 
VERSION. 

CURRENTLY  THIS  ROUTINE  SIMPLY  RETURNS  THE  ASCII 
VALUE  OF  ANY  KEY  THAT  HAS  BEEN  DEPRESSED  ON  THE 
SYSTEM  CONSOLE  KEYBOARD.  A  VALUE  OF  ZERO  IS 
RETURNED  IF  A  KEY  HAS  NOT  BEEN  PRESSED. 


LD 

CALL 

OR 

RET 


C ,  OBH 

CDSSYS 

A 


;  CDOS  TEST  CONSOLE  READY 
; CDOS  SYSTEM  ENTRY  POINT 
; SET  CONDITION  CODES 


;  THIS  ROUTINE  SAVES  THE  JOB  ADDRESS  PASSED  IN  THE  HL 

;  REGISTER  AND  THEN  FALLS  THROUGH  TO  THE  READ  NOVA 

;  ROUTINE. 

SVJADR :  LD  ( JOB ADR) , HL  ;SAVE  JOB  ADDRESS 


THIS  ROUTINE  READS  THE  NOVA  STATUS  FLAGS  CHECKING 
FOR  THE  NOVA  BUSY  FLAG  TO  BE  SET.  IF  THE  BUSY 
FLAG  IS  SET  THE  ROUTINE  RETURNS  WITH  THE  CARRY 
SET  AND  THE  WORD  RECEIVED  VIA  THE  NOVA'S  C-PORT 
IN  THE  BC  REGISTER. 


RDNOVA:  IN 

A,  (FLAGS) 

;GET  NOVA  STATUS  FLAGS 

RRA 

; NOVA  BUSY  FLAG  TO  CARRY 

RET 

NC 

; RETURN  IF  BUSY  NOT  SET 

IN 

A,  (DATAHI) 

;GET  HI  BYTE  OF  NOVA  WORD 

LD 

B,A 

; MOVE  TO  COMMAND  REGISTER 

IN 

A, (DATALO) 

;GET  LO  BYTE  OF  NOVA  WORD 
; DONE  FLAG  WILL  BE  SET 

LD 

RET 

C,  A 

; MOVE  TO  COMMAND  REGISTER 

THIS  ROUTINE  CONTINUOUSLY  READS  THE  NOVA  STATUS 


5 

FLAGS 

UNTIL  THE  NOVA 

DONE  FLAG  IS  CLEARED. 

TSTDON : 

IN 

RLA 

A, (FLAGS) 

;GET  NOVA  STATUS  FLAGS 
; NOVA  DONE  FLAG  TO  CARRY 

JR 

RET 

C, TSTDON 

; TAKEN  IF  DONE  FLAG  SET 

THIS  ROUTINE  WAITS  FOR  THE  NOVA  DONE  FLAG  TO  CLEAR 
THEN  SENDS  THE  INFORMATION  PASSED  IN  THE  BC  REGISTER. 

BECAUSE  OF  AN  UNDETERMINED  PROBLEM  IN  THE  I/O 
CHANNEL  THIS  ROUTINE  HAD  TO  BE  MODIFIED  TO  ENSURE 
THAT  THE  DONE  FLAG  ACTUALLY  GETS  SET.  THE  CODE 
BEGINNING  AT  THE  LABEL  ’ PATCH '  WAS  ADDED  TO  CAUSE 
THE  CROMEMCO  TO  LOOP  UNTIL  IT  SENSES  A  SET  DONE 
FLAG.  EACH  TIME  THROUGH  THE  LOOP  A  MESSAGE 
INDICATING  THAT  A  CLEARED  DONE  FLAG  WAS  DETECTED 
IS  PRINTED  TO  THE  SYSTEM  CONSOLE.  THIS  PROBLEM 
MUST  BE  CORRECTED  AND  THIS  PATCH  REMOVED  BEFORE 
ATTEMPTING  TO  PLACE  THE  CHOPS  IN  ROM  OR  REMOVING 
THE  SYSTEM  CONSOLE. 

***«#***«*«*«*««***ft*«*««**««*««ff***««*«*«*«*«««««**#««* 


WRNOVA: 

CALL 

TSTDON 

; WAIT  FOR  DONE  TO  CLEAR 

WRNOV1 : 

LD 

A,B 

;GET  HI  BYTE 

OUT 

(DATAHI)  ,  A 

; SEND  HI  BYTE  TO  NOVA 

LD 

A ,  C 

;GET  LO  BYTE 

OUT 

(DATALO) , A 

;  SEND  LO  BYTE  TO  NOVA 
;D0NE  FLAG  IS  SET 

PATCH: 

IN 

RLA 

A, (FLAGS) 

;GET  NOVA  FLAGS 
; NOVA  DONE  FLAG  TO  CARRY 

RET 

C 

; RETURN  IF  DONE  FLAG  SET 

J 

PUSH 

DE 

; SAVE  DE  CONTENTS 

PUSH 

BC 

; SAVE  BC  CONTENTS 

LD 

DE , MSG 

;GET  ADDRESS  OF  MESSAGE 

LD 

C,09H 

; CDOS  PRINT  BUFFERED  LINE 

CALL 

CDSSYS 

; CDOS  SYSTEM  CALL 

POP 

BC 

; RESTORE  BC 
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POP 

DE 

{RESTORE  DE 

• 

JR 

WRNOV1 

{TAKEN  TO  ENSURE  DONE  FLAG 
;IS  SET 

MSG: 

DB 

RET 

•RE-ATTEMPTING 

TO  SET  DONE  FLAG • , CR , LF, • $ ' 

THIS  ROUTINE  TESTS  THE  ABSOLUTE  VALUE  OF  THE  WORD 
PASSED  IN  THE  BC  REGISTER  WITH  RESPECT  TO  THE  WORD 
STORED  IN  THE  MEMORY  LOCATION  ADDRESSED  BY  THE  HL 
REGISTER.  THE  CARRY  CODE  IS  SET  IF  THE  WORD  IN 
THE  BC  REGISTER  IS  GREATER  THAN  THE  WORD  IN  MEMORY. 
IF  THE  TWO  WORDS  ARE  EQUAL  THE  ZERO  CONDITION  CODE 
WILL  BE  SET  AND  THE  CARRY  CODE  WILL  BE  CLEARED. 

THE  WORD  STORED  IN  MEMORY  MUST  BE  STORED  IN  THE 
CONVENTIONAL  LO  BYTE/HI  BYTE  FORM  (WITH  THE  LO 
BYTE  IN  THE  LOWER  ADDRESS). 


BNDTST :  INC 

DEC 

CP 

RET 


HL 

LD 

HL 

B 

NZ 


A, (HL) 


SET  MEMORY  POINTER  TO  THE 
HI  BYTE ;GET  THE  BOUND  HI  BYTE 
POINT  TO  LO  BYTE  OF  BOUND 
CHECK  DATA  HI  BYTE  AGAINST 
STORED  BOUND 

RETURN  WITH  CARRY  SET  IF 
NUMBER  IN  BC  REGISTER  IS 
LARGER  THAN  THE  BOUND 


LD  A, ( HL)  ;GET  THE  BOUND  LO  BYTE 

CP  C  ; CHECK  DATA  LO  BYTE  AGAINST 

STORED  BOUND 

RET  -RETURN  WITH  CARRY  SET  IF 

NUMBER  IN  BC  REGISTER  IS 
LARGER  THAN  THE  BOUND 


THE  FOLLOWING  ROUTINE  SETS  UP  THE  DATA  BUFFER  AND 
PARAMETER  BUFFER  POINTERS. 


SETBUF :  LD 
LD 
RET 


HL, (DATSTR) 
DE , ( PRMBUF) 


GET  STARTING  ADDRESS  OF 
THE  DATA  BUFFER 
GET  THE  ADDRESS  OF  THE 
FIRST  PARAMETER 


;  THE  FOLLOWING  ROUTINE  INITIALIZES  THE  DATA  BUFFER 

;  POINTER  STORAGE  LOCATIONS  TO  INDICATE  THAT  THE 

;  ENTIRE  REMAINING  MEMORY  IS  AVAILABLE  FOR  DATA 

;  STORAGE. 

SBUFDF :  LD  HL, ( LOMEM)  ;GET  ABSOLUTE  LOWEST  ADDRESS 

{AVAILABLE  IN  RAM  SPACE 


LD 

(DATSTR) , HL 

;SAVE  AS  THE  DATA 
; STARTING  ADDRESS 

BUFFER 

LD 

HL , ( HIMEM) 

;GET  ABSOLUTE  HIGHEST  ADDRESS 
; AVAILABLE  IN  RAM  SPACE 

LD 

RET 

(DATEND) , HL 

; SAVE  AS  THE  DATA 
; ENDING  ADDRESS 

BUFFER 

THE  FOLLOWING  ROUTINE  SETS  THE  DCH/DMA  CONTROL 
REGISTER  TO  THE  BYTE  PASSED  IN  THE  ACCUMULATOR. 
IT  ALSO  INITIALIZES  THE  DATA  AND  PARAMETER 
BUFFER  POINTERS  AND  SAVES  THE  DATA  CHANNEL 
BLOCK  SIZE  THAT  IS  PASSED  IN  THE  DE  REGISTER. 


DCHSET : 

OUT 

(DCHDMA)  ,  A 

; SET  DCH/DMA  CONTROL  REG. 

CALL 

SETBUF 

; SET  UP  DATA  BUFFER  AND 
; PARAMETER  BUFFER  START 

LD 

RET 

( BLKSIZ) , DE 

; SAVE  DCH  BLOCK  SIZE 

THE  FOLLOWING  ROUTINE  CONTINUOUSLY  READS  THE  NOVA 
FLAGS  AND  DOES  NOT  RETURN  UNTIL  THE  DATA  CHANNEL 
READY  FLAG  IS  SET. 


DCHRDY : 

IN 

RLA 

RLA 

A, (FLAGS) 

;GET  NOVA  FLAGS 
; MOVE  DCH  READY  FLAG  INTO 
; THE  CARRY 

JR 

RET 

NC, DCHRDY 

; TAKEN  UNTIL  DCH  READY 

;  THE  FOLLOWING  ROUTINE  TRANSMITS  THE  ECHO  COMMAND 

;  THAT  IS  PASSED  IN  THE  'BC'  REGISTER.  IT  THEN 

;  WAITS  FOR  THE  NOVA  TO  CLEAR  THE  DONE  FLAG  WHICH 

;  ACKNOWLEDGES  RECEIPT  OF  THE  COMMAND  ECHO.  THE 

;  ROUTINE  THEN  ATTEMPTS  TO  READ  A  NEW  COMMAND 

;  FROM  THE  NOVA.  IF  IT  DOES  NOT  FIND  A  NEW  COMMAND 

;  THE  ROUTINE  RETURNS  WITH  THE  CARRY  CODE  CLEARED. 

;  IF  A  NEW  COMMAND  IS  PRESENT  THE  ROUTINE  WILL 

;  CHECK  THE  RECEIVED  COMMAND  AGAINST  THE  EXPECTED 

;  COMMAND  CONTAINED  IN  THE  'DE'  REGISTER.  IF  A 

;  MATCH  IS  FOUND  THE  ZERO  CONDITION  CODE  IS  SET; 

;  OTHERWISE,  THE  ROUTINE  RETURNS  WITH  ONLY  THE 

;  CARRY  CODE  SET.  THIS  ROUTINE  ALSO  IS  USED  TO 

;  WAIT  FOR  AND  VALIDATE  EACH  DATA  COMMAND  AS  IT  IS 

;  RECEIVED.  THE  ENTRY  POINT  FOR  THE  LATTER  IS  AT 

;  'GETDCM'.  AFTER  RECEIVING  A  DATA  COMMAND  THE 

;  ROUTINE  FUNCTIONS  AS  FOR  ANY  OTHER  RECEPTION. 

CMDATA :  LD  BC , DTCM1 +M0DE2  ;SET  UP  MODE  "01"  DATA 

; COMMAND  WITH  COMPLETION  SET 
CMDTST :  CALL  WRNOVA  ; SEND  IT  TO  THE  NOVA 
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GETDCM : 

CPBCDE : 


DBETST : 


INPDAT : 


CALL 

TSTDON 

WAIT  FOR  DONE  TO  CLEAR 

CALL 

RDNOVA 

CHECK  FOR  NEW  COMMAND 

RET 

NC 

•TAKEN  IF  NO  NEW  COMMAND 

JR 

CPBCDE 

TAKEN  TO  VALIDATE  THE 

NEW  COMMAND 

CALL 

RDNOVA 

CHECK  FOR  NEW  DATA  COMMAND 

JR 

NC, GETDCM 

TAKEN  IF  DATA  COMMAND  NOT 
RECEIVED  YET 

CP 

E 

CHECK  LO  BYTE  OF  RECEIVED 
COMMAND  AGAINST  WHAT  WAS 
EXPECTED 

SCF 

SET  CARRY  TO  INDICATE  THAT 
SOMETHING  WAS  RECEIVED 

RET 

NZ 

TAKEN  IF  NO  MATCH 

LD 

A,  B 

MOVE  HI  BYTE  FOR  TEST 

CP 

D 

CHECK  HI  BYTE 

SCF 

INDICATE  RECEPTION 

RET 

THE  FOLLOWING  ROUTINE 

IS  USED  BY  THE  DATA  TRANSFER 

ROUTINES  TO  TEST  FOR 

WHEN  THE  END  OF  THE  DATA 

BUFFER 

HAS  BEEN  REACHED.  THIS  ROUTINE  WILL 

RETURN 

WITH  THE  CARRY 

CODE  SET  IF  THE  END  OF  THE 

DATA  BUFFER  HAS  BEEN 

REACHED  OR  EXCEEDED. 

PUSH 

BC 

; SAVE  ’BC' 

PUSH 

HL 

; SAVE  DATA  BUFFER  POINTER 

DEC 

HL 

;BACK  UP  ONE  LOCATION 

PUSH 

HL 

; MOVE  CONTENTS  OF  ’HL’  TO 

POP 

BC 

; THE  'BC'  REGISTER 

LD 

HL, DATTST 

;GET  ADDRESS  OF  BUFFER 

; ENDING  ADDRESS 

CALL 

BNDTST 

; COMPARE  THE  TWO 

POP 

HL 

; RESTORE  BUFFER  POINTER 

POP 

BC 

; RESTORE  ’BC’ 

RET 

THE  FOLLOWING  ROUTINE  PROVIDES  THE  INPUT  CAPABILITY 
FOR  DATA  THAT  IS  RECEIVED  VIA  MODE  "01”  PROGRAMMED 
I/O.  THE  RECEIVED  DATA  IS  STORED  IN  MEMORY  AS  TWO 
BYTES  AT  THE  LOCATION  THAT  THE  ’HL’  REGISTER  IS 
ADDRESSING  ON  ENTRY.  THIS  DATA  IS  STORED  IN  A 
HI  BYTE/LO  BYTE  FORM  WITH  THE  HI  BYTE  IN  THE  LOWER 
ADDRESS.  THE  'HL'  REGISTER  WILL  BE  INCREMENTED  BY 
TWO  ON  RETURN. 


CALL  RDNOVA 

JR  NC, INPDAT 


GET  A  WORD  FROM  THE  NOVA 
TAKEN  TO  LOOP  UNTIL  A 
WORD  IS  RECEIVED 


4 
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r  *5 


t 


4 

/■ 


SAVDAT:  LD 

(HL) ,B 

; SAVE  HI  BYTE  IN  THE  DATA 

; BUFFER 

INC 

HL 

; BUMP  DATA  POINTER 

LD 

(HL) ,C 

; SAVE  LO  BYTE  IN  BUFFER 

INC 

HL 

; BUMP  DATA  POINTER 

RET 

1 


THE  FOLLOWING  ROUTINE  PROVIDES  THE  OUTPUT  CAPABILITY 
FOR  DATA  THAT  IS  TRANSMITTED  USING  THE  MODE  ”01" 
PROGRAMMED  I/O.  THE  TRANSMITTED  DATA  IS  RETRIEVED 
FROM  THE  DATA  BUFFER  ADDRESS  THAT  IS  CONTAINED  IN 
THE  *HL»  REGISTER  ON  ENTRY.  THE  HI  BYTE  OF  THE 
DATA  MUST  BE  STORED  IN  THE  LOWER  ADDRESS.  BOTH 
BYTES  OF  THE  DATA  WILL  BE  TRANSMITTED  AND  THE  '  HL ' 
REGISTER  WILL  BE  INCREMENTED  TWICE  ON  RETURN. 


OUTDAT:  LD 

B, ( HL) 

;GET  HI  BYTE  OF  DATA 

INC 

HL 

; BUMP  DATA  POINTER 

LD 

C , ( HL) 

;GET  LO  BYTE  OF  DATA 

INC 

HL 

; BUMP  DATA  POINTER 

CALL 

WRNOVA 

; SEND  DATA  TO  NOVA 

RET 

THE  FOLLOWING  ROUTINE  PROVIDES  THE  INPUT  CAPABILITY 
FOR  DATA  THAT  IS  TO  BE  RECEIVED  USING  A  MODE  "10" 
DATA  CHANNEL  TRANSFER.  THE  RECEIVED  DATA  IS  PUT 
INTO  THE  DATA  BUFFER  IN  THE  SAME  MANNER  AS  THE 
PREVIOUSLY  DESCRIBED  "INPDAT"  ROUTINE.  THIS 
ROUTINE  MUST  BE  ENTERED  WITH  THE  PORT  ADDRESS  OF 
THE  LOW  DATA  BYTE  IN  THE  *C*  REGISTER.  SINCE  THE 
CHANNEL  TRANSFERS  USE  NOVA  DISK  BLOCKS  (256  WORDS) 
AS  THE  MEDIUM  FOR  MEASURING  THE  NUMBER  OF  DATA 
WORDS  TRANSFERRED,  THIS  ROUTINE  RETURNS  WITH  THE 
•B'  REGISTER  DECREMENTED  BY  ONE  TO  HELP  COUNT  THE 
WORDS  THAT  HAVE  BEEN  TRANSFERRED. 


iNPDCH : 

OUT 

(DCHREQ)  ,  A 

; REQUEST  DCH  FROM  NOVA 

CALL 

DCHRDY 

; WAIT  FOR  DCH  TO  COMPLETE 

INC 

C 

; BUMP  INPUT  PORT  POINTER 
; TO  GET  HI  BYTE  OF  DATA 

INI 

;GET  NOVA  HI  BYTE  DATA 

INC 

B 

; BUMP  DISK  BLOCK  COUNTER 
; SO  IT  WILL  INDICATE 
; WORDS  TRANSFERRED 

DEC 

C 

; DECREASE  INPUT  PORT 
; POINTER  FOR  LO  DATA  BYTE 

INI 

;GET  NOVA  LO  BYTE  DATA 

RET 
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THE  FOLLOWING  ROUTINE  PROVIDES  THE  OUTPUT  CAPABILITY 
FOR  DATA  THAT  IS  TO  BE  TRANSMITTED  TO  THE  NOVA 
USING  A  MODE  "10"  DATA  CHANNEL  TRANSFER.  THE  DATA 
TO  BE  TRANSMITTED  IS  RETRIEVED  FROM  THE  DATA  BUFFER 
IN  THE  SAME  MANNER  AS  THE  'OUTDAT*  ROUTINE.  THE 
ENTRY  REQUIREMENTS  AND  EXIT  CONDITIONS  ARE  THE  SAME 
AS  THOSE  FOR  THE  ‘INPDCH*  ROUTINE. 


OUTDCH : 

INC 

OUTI 

C 

;BUMP  OUTPUT  PORT  POINTER 
; TO  SEND  HI  BYTE  OF  DATA 
; PUT  HI  BYTE  IN  OUTPUT  PORT 

INC 

B 

; ONLY  WANT  TO  COUNT  WORDS 

DEC 

OUTI 

C 

; POINT  TO  LO  BYTE  OUTPUT  PORT 
; PUT  LO  BYTE  IN  OUTPUT  PORT 

CALL 

DCHRDY 

; IS  NOVA  READY? 

9 

OUT 

RET 

( DCHREQ ) , A 

; REQUEST  OUTPUT  DCH 

9 

END 

BEGIN 

; END  OF  CHOPS 

Ill 
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NOVA/CROMEMCO 

CHANNEL  OPERATING  SYSTEM 

CHOPS 

MAIN  COMMAND  TABLE 
AND 

COMMAND  INFORMATION  LISTS 
VERSION  2.0 


WRITTEN  BY 

CAPT  GEORGE  C.  BEASLEY,  JR.,  USAF 
MARCH  1981 


THE  FOLLOWING  TABLE  CONTAINS  ALL  THE  INFORMATION 
REQUIRED  BY  THE  CHOPS  FOR  IT  TO  RECEIVE  AND 
VALIDATE  COMMANDS  AND  PARAMETERS  ASSOCIATED  WITH 
PARTICULAR  TASKS.  WHEN  NEW  TASKS  ARE  ADDED  THE 
PROPER  ENTRIES  MUST  BE  MADE  TO  THIS  TABLE  TO 
ALLOW  THE  CHOPS  TO  GAIN  KNOWLEDGE  OF  THE  NEW 
CAPABILITY. 

ENTRY  COMTBL 

THE  FOLLOWING  GLOBAL  REFERENCES  ALLOW  THE  TABLE  TO 
BE  PROPERLY  FORMED  BY  THE  LINKER.  THE  SYMBOLIC 
NAME  OF  EACH  TASK  ADDRESS  ENTERED  IN  THE  TABLE 
MUST  ALSO  BE  ENTERED  IN  AN  EXTERNAL  STATEMENT  LIKE 
THE  FOLLOWING  NAMES. 

EXT  CMSTAT 

EXT  TSK0OO,TSK00I,TSKO10,TSK01I,TSK02O,TSK02I 

EXT  TSK030, TSK03I 


THE  FOLLOWING  ORIGIN  ADDRESS  MAY  NEED  TO  BE  CHANGED 
FOR  DIFFERENT  VERSIONS  OF  THE  CHOPS;  THEREFORE,  THE 
VERSION  NUMBER  OF  THIS  TABLE  MUST  MATCH  THE  VERSION 
NUMBER  OF  THE  MAIN  SYSTEM  ROUTINES. 


COMTBL : 


CILOOO : 


1 


THIS  PARTICULAR  TABLE  WAS  ESTABLISHED  FOR  CHOPS 
VERSION  2.0  AND  WILL  HAVE  TO  BE  ALTERED  WHEN  THE 
CHOPS  IS  PLACED  IN  ROM. 


ORG  OBOOH 


THIS  ADDRESS  MUST  ALWAYS 
BE  SET  ON  A  PAGE  BOUNDARY 
(LO  BYTE  =  00) 


THE  FIRST  256  BYTES  OF  THE  TABLE  CONSISTS  OF  THE 
POINTERS  TO  THE  COMMAND  INFORMATION  LIST  FOR  EACH 
VALID  COMMAND.  CURRENTLY  ALL  OF  THE  COMMAND 
INFORMATION  LISTS  ARE  CONTAINED  IN  THE  MAIN  TABLE 
FOLLOWING  THESE  POINTERS.  THE  LISTS  COULD  BE 
LOCATED  WITHIN  THE  TASK  ITSELF. 


DW 

CILOOO 

; CIL  -  TASK 

00  -  OUTPUT 

DW 

CILOOI 

; CIL  -  TASK 

00  -  INPUT 

DW 

CIL010 

; CIL  -  TASK 

01  -  OUTPUT 

DW 

CIL01I 

; CIL  -  TASK 

01  -  INPUT 

DW 

CIL020 

; CIL  -  TASK 

02  -  OUTPUT 

DW 

CIL02I 

; CIL  -  TASK 

02  -  INPUT 

DW 

CIL030 

; CIL  -  TASK 

03  -  OUTPUT 

DW 

CIL03I 

; CIL  -  TASK 

03  -  INPUT 

ALL  INVALID  TASK  NUMBERS  HAVE  AN  ADDRESS  OF  ZERO 
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,0 

,0 
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,0 

DW 

0 

,0 

,0, 

,0 

,0 

,0 

,0 

,0 

,0 

,0 

,0 

,0 

,0 

,0 

,0 

,0 

,0, 

,0 

,0 

,0 

THE 

FOLLOWING 

ARE 

THE 

COMMAND 

INFORMATION 

LISTS 

ASSOCIATED  WITH  EACH  TASK. 


DB  0 1 0H 

DW  CMSTAT 

DW  OOOOOH 

DW  00400H 

DW  TSKOOO 


LO  NIBBLE  -  PARAMETER  COUNT 
HI  NIBBLE  -  DATA  FLAG  SET 
STATUS  LOCATION  FOR  OUTPUT 
TASK  00 

DATA  COUNT  LO  BOUND 
DATA  COUNT  HI  BOUND 
NO  ACTUAL  PARAMETERS  SINCE 
PARAMETER  COUNT  IS  ZERO 
DATA  COUNT  INCLUDED  SINCE 
DATA  FLAG  IS  SET 
ADDRESS  OF  TASK  00 
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CILOOI: 


CILOIO: 


CILOII: 


CIL020 : 


DB 

1 0H 

DW 

CMSTAT+1 

DW 

OOOOOH 

DW 

00400H 

DW 

TSKOOI 

DB 

012H 

DW 

CMSTAT+2 

DW 

OOOOOH 

DW 

00400H 

DW 

00070H 

DW 

OFFFFH 

DW 

OOOOOH 

DW 

OOO  1 0H 

DW 

TSK010 

DB 

012H 

DW 

CMSTAT+3 

DW 

OOOOOH 

DW 

00400H 

DW 

00070H 

DW 

OFFFFH 

DW 

OOOOOH 

DW 

00004H 

DW 

TSK01I 

DB 

014H 

DW 

CMSTAT+4 

DW 

OOOOOH 

DW 

00400H 

DW 

OOOOOH 

DW 

05800H 

DW 

OOOOOH 

DW 

05800H 

DW 

00070H 

DW 

OFFFFH 

DW 

OOOOOH 

DW 

000 1  OH 

DW 

TSK020 

; ZERO  PARAMETERS  -  SET  DATA 
; STATUS  LOCATION 
; DATA  COUNT  LO  BOUND 
;  DATA  COUNT  HI  BOUND 
; TASK  ADDRESS 

; TWO  PARAMETERS  -  SET  DATA 
; STATUS  LOCATION 
; DATA  COUNT  LO  BOUND 
;DATA  COUNT  HI  BOUND 
{ONE  LESS  THAN  THE  MINIMUM 
{SAMPLE  RATE  SETTING 
{MAX.  SAMPLE  RATE  SETTING 
{ONE  LESS  THAN  THE  LOWEST 
;  A/D  CHANNEL 
{HIGHEST  A/D  CHANNEL 
{TASK  ADDRESS 

{TWO  PARAMETERS  -  SET  DATA 
{STATUS  LOCATION 
{DATA  COUNT  LO  BOUND 
{DATA  COUNT  HI  BOUND 
{ONE  LESS  THAN  THE  MINIMUM 
{SAMPLE  RATE  SETTING 
{MAX.  SAMPLE  RATE  SETTING 
{ONE  LESS  THAN  THE  LOWEST 
;D/A  CHANNEL 
{HIGHEST  D/A  CHANNEL 
{TASK  ADDRESS 

FOUR  PARAMETERS  -  SET  DATA 
STATUS  LOCATION 
DATA  COUNT  LO  BOUND 
DATA  COUNT  HI  BOUND 
ONE  LESS  THAN  THE  LOWEST 
PLACE  TO  START  RETRIEVING 
DATA  FROM  THE  BUFFER 
THE  HIGHEST  PLACE  IN  THE 
DATA  BUFFER  FROM  WHICH 
DATA  CAN  BE  RETRIEVED 
ONE  LESS  THAN  THE  LOWEST 
NUMBER  OF  DATA  WORDS  TO 
BE  TRANSFERRED 
THE  LARGEST  NUMBER  OF 
DATA  WORDS  THAT  CAN  BE 
TRANSFERRED 

ONE  LESS  THAN  THE  MINIMUM 
SAMPLE  RATE  SETTING 
MAX.  SAMPLE  RATE  SETTING 
ONE  LESS  THAN  THE  LOWEST 
A/D  CHANNEL 
HIGHEST  A/D  CHANNEL 
TASK  ADDRESS 
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CIL02I:  DB 

DW 

DW 

DW 

0 1 4  H 
CMSTAT+5 
OOOOOH 
00400H 

DW 

OOOOOH 

DW 

05800H 

DW 

OOOOOH 

DW 

05800H 

DW 

00070H 

DW 

DW 

OFFFFH 

OOOOOH 

DW 

DW 

00004H 

TSK02I 

CIL030 :  DB 

DW 

DW 

DW 

DW 

01 1 H 

CMSTAT+6 

OOOOOH 

00400H 

OOOOOH 

DW 

OFFFFH 

DW 

TSK030 

CIL03I:  DB 

DW 

DW 

DW 

DW 

0 1 1  H 

CMSTAT+7 

OOOOOH 

00400H 

OOOOOH 

DW 

OFFFFH 

DW 

! 

TSK03I 

END 

; FOUR  PARAMETERS  -  SET  DATA 
; STATUS  LOCATION 
; DATA  COUNT  LO  BOUND 
; DATA  COUNT  HI  BOUND 

;ONE  LESS  THAN  THE  LOWEST 
;  PLACE  TO  START  RETRIEVING 
;  DATA  FROM  THE  BUFFER 
;  THE  HIGHEST  PLACE  IN  THE 
;  DATA  C"CFER  FROM  WHICH 
;  DATA  ai  BE  RETRIEVED 
;  ONE  LESS  THAN  THE  LOWEST 
;  NUMBER  OF  DATA  WORDS  TO 
; BE  TRANSFERRED 
;  THE  LARGEST  NUMBER  OF 
;  DATA  WORDS  THAT  CAN  BE 
;  TRANSFERRED 

;  ONE  LESS  THAN  THE  MINIMUM 
;  SAMPLE  RATE  SETTING 
; MAX.  SAMPLE  RATE  SETTING 
;  ONE  LESS  THAN  THE  LOWEST 
;  D/A  CHANNEL 
;  HIGHEST  D/A  CHANNEL 
;  TASK  ADDRESS 

ONE  PARAMETER  -  SET  DATA 
STATUS  LOCATION 
DATA  COUNT  LO  BOUND 
DATA  COUNT  HI  BOUND 
ONE  LESS  THAN  THE  LOWEST 
SETTING  OF  DISPLAY  TIME 
THE  HIGHEST  SETTING  OF 
THE  DISPLAY  TIME 
TASK  ADDRESS 


DATA  COUNT  LO  BOUND 
DATA  COUNT  HI  BOUND 
ONE  LESS  THAN  THE  LOWEST 
SETTING  OF  DISPLAY  TIME 
THE  HIGHEST  SETTING  OF 
THE  DISPLAY  TIME 
TASK  ADDRESS 


;  END  OF  COMMAND  TABLE 
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xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 

NOVA/CROMEMCO 
CHANNEL  OPERATING  SYSTEM 
CHOPS 
TASK  NUMBER  ZERO 

(ENTIRE  DATA  BUFFER  SEND  AND  RECEIVE) 

VERSION  1.0 

WRITTEN  BY 

CAPT  GEORGE  C.  BEASLEY,  JR.,  USAF 
MARCH  1981 

XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX 


THE  FOLLOWING  TASK  IS  A  VERY  SIMPLE  ROUTINE  THAT 
CAUSES  THE  ENTIRE  DATA  BUFFER  TO  BE  FILLED  FROM 
THE  NOVA  FOR  AN  INPUT  COMMAND  AND  TO  BE  EMPTIED 
INTO  THE  NOVA  BY  AN  OUTPUT  COMMAND.  THERE  IS 
NO  OTHER  I/O  ASSOCIATED  WITH  THIS  TASK  OTHER 
THAN  THE  TRANSACTIONS  TO  AND  FROM  THE  NOVA. 

THE  FOLLOWING  EXTERNAL  ROUTINES  AND  VARIABLES  ARE 
AVAILABLE  FOR  USE  BY  THIS  TASK. 

EXT  TCMPLT, ERROR , DATOUT , DCHOUT, DATINP , DCHINP 
EXT  DOJOBO, DOJOBI , LOMEM, HIMEM,DATSTR,DATEND 

EXT  SBUFDF 


THE  FOLLOWING  DEFINITION  ALLOWS  THE  COMMAND  TABLE 
TO  PICK  UP  THE  TASK  ADDRESS  DURING  LINKING.  THESE 
ENTRY  POINT  ADDRESSES  MUST  BE  SPECIFIED  IN  THIS 
MANNER  TO  ALLOW  THE  TASK  ADDRESS  TO  BE  INCLUDED  IN 
THE  COMMAND  TABLE. 

ENTRY  TSKOOO , TSKOOI 


ERR6  EQU  06H  ;ERROR  CODE  FOR 

; "INVALID  COMMAND  MODE" 


> 
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OUTPUT  TASK  00 


TSKOOO : 

JR 

OMODEO 

J 

• 

JR 

0M0DE1 

9 

JR 

0M0DE2 

0M0DE3: 

JP 

TCMPLT 

OMODEO: 

LD 

E, ERR6 

JP 

ERROR 

0M0DE1 : 

LD 

DE,DATOUT 

JR 

GTOJOB 

0M0DE2 : 

LD 

DE,DCHOUT 

GTOJOB : 

• 

9 

CALL 

LD 

JP 

SBUFDF 

HL, JOBOO 
DOJOBO 

9 

9 

INPUT 

TASK  00 

TSKOOI: 

JR 

OMODEO 

9 

JR 

IM0DE1 

9 

JR 

IM0DE2 

9 

JR 

0M0DE3 

IM0DE1  : 

LD 

DE,DATINP 

JR 

GTIJOB 

IM0DE2: 

LD 

DE , DCHINP 

GTIJOB : 

CALL 

LD 

JP 

SBUFDF 

HL, JOBOO 
DOJOBI 

9 

• 

9 

9 

THIS 

NULL 

IS  ALL  THERE 
JOB. 

JOBOO: 

SCF 

CCF 

RET 

END 

MODE  "00"  ENTRY  POINT 

MODE  ”01"  ENTRY  POINT 

MODE  "10"  ENTRY  POINT 

MODE  "11"  ENTRY  POINT 

MODE  "00"  NOT  AVAILABLE 
SET  "INVALID  COMMAND  MODE" 
TAKEN  TO  HANDLE  ERROR 

GET  ADDRESS  OF  MODE  "01" 
OUTPUT  DATA  HANDLER 
TAKEN  TO  CONTINUE  TASK 
SET  UP 

GET  ADDRESS  OF  MODE  "10" 
OUTPUT  DATA  HANDLER 
SET  BUFFER  DEFAULTS 
GET  JOB  ADDRESS 
LET  THE  CHOPS  DO  THE  WORK 


; MODE  "00"  ENTRY  POINT 

; MODE  "01"  ENTRY  POINT 

; MODE  "10"  ENTRY  POINT 

; MODE  "11"  ENTRY  POINT 

;GET  ADDRESS  OF  MODE  "01" 

; INPUT  DATA  HANDLER 
; TAKEN  TO  CONTINUE  TASK 
; SET  UP 

;GET  ADDRESS  OF  MODE  "10" 

; INPUT  DATA  HANDLER 
; SET  BUFFER  DEFAULTS 
;GET  JOB  ADDRESS 
; LET  THE  CHOPS  DO  THE  WORK 

OF  JOB  00.  IT  CONSISTS  OF  A 


; CLEAR  CARRY  FLAG  SO 
; CHOPS  THINKS  ALL  IS  OK 

; END  OF  TASK  00 


t 


NOVA/CROMEMCO 

CHANNEL  OPERATING  SYSTEM 

CHOPS 

TASK  NUMBERS  ONE  AND  TWO 
(A/D  AND  D/A  COLLECTION  AND  TRANSFER) 

VERSION  1.0 

WRITTEN  BY 

CAPT  GEORGE  C.  BEASLEY,  JR.,  USAF 
MARCH  1981 


««««*«*«ft*««**«C*««*«*****«*«*****«**««*«*X***«*«**«**«ft* 


THE  FOLLOWING  TWO  TASKS  PROVIDE  THE  CAPABILITY  OF 
COLLECTING,  TRANSFERRING,  AND  RECONSTRUCTING  DATA 
WITH  THE  A/D  AND  D/A  CONVERTERS  OF  THE  SYSTEM. 

TASK  ONE  REQUIRES  TWO  PARAMETERS. 

PARAMETER  ONE  =  SAMPLING  TIME  INDICATOR 
PARAMETER  TWO  =  A/D  OR  D/A  CHANNEL  NUMBER 

PARAMETER  ONE  IS  CALCULATED  FROM  THE  FORMULA: 

STI  =  INTEGER  ( 2x 10~6/SAMPLING  FREQUENCY) 

CURRENT  LIMITATIONS  REQUIRE  THIS  NUMBER 
TO  BE  GREATER  THAN  199. 

PARAMETER  TWO  SELECTS  ONE  OF  SIXTEEN  A/D  CHANNELS 
FOR  THE  I/O  CHANNEL  OUTPUT  TASK  OR  ONE  OF  FOUR 
D/A  CHANNELS  FOR  THE  I/O  CHANNEL  INPUT  TASK. 


TASK  TWO  REQUIRES  FOUR  PARAMETERS. 

PARAMETER  ONE  =  STARTING  DATA  WORD  FOR  A/D  OR  D/A 

PARAMETER  TWO  =  TOTAL  NUMBER  OF  DATA  WORDS  FOR 

A/D  OR  D/A 

PARAMETER  THREE  =  SAMPLING  TIME  INDICATOR 
PARAMETER  FOUR  =  A/D  OR  D/A  CHANNEL  NUMBER 

PARAMETER  ONE  PROVIDES  AN  INDICATION  TO  THE  TASK  OF 
THE  WORD  IN  THE  DATA  BUFFER  AT  WHICH  THE  A/D  OR  D/A 
CONVERSION  AND/OR  TRANSFER  SHOULD  BEGIN. 


* 
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PARAMETER  TWO  DETERMINES  THE  TOTAL  NUMBER  OF  WORDS 
THAT  WILL  BE  CONVERTED  AND/OR  TRANSFERRED. 


PARAMETERS  THREE  AND  FOUR  ARE  THE  SAME  AS  PARAMETERS 
ONE  AND  TWO,  RESPECTIVELY,  OF  TASK  ONE. 


EXT 

TCMPLT, ERROR, 

DATOUT , DCHOUT , DATINP, DCHINP 

EXT 

DOJOBO, DOJOBI 

,  LOMEM, HIMEM, DATSTR , DATEND 

f 

EXT 

BNDTST, PRMBUF 

, SBUFDF, USERAM 

9 

• 

9 

THE  FOLLOWING  DEFINITION  ALLOWS  THE  COMMAND  TABLE 

> 

TO  PICK  UP  THE  TASK 

ADDRESS  DURING  LINKING.  THESE 

1 

ENTRY 

POINT  ADDRESSES  MUST  BE  SPECIFIED  IN  THIS 

9 

MANNER 

TO  ALLOW  THE 

TASK  ADDRESS  TO  BE  INCLUDED  IN 

• 

9 

THE  COMMAND  TABLE. 

9 

« 

9 

ENTRY 

TSKO 1 0 , TSKO 1 I 

, TSK020 , TSK02I 

SWTFLG : 

EQU 

0037H 

; STORAGE  ADDRESS  FOR 
; SWITCH  FLAG 

IVCTOR : 

EQU 

0038H 

; ADDRESS  FOR  INTERRUPT  JUMP 

SWTMSK : 

EQU 

020H 

; MASK  FOR  EXTRACTING 
; SWITCH  STATUS 

ERR6 

EQU 

06H 

; ERROR  CODE  FOR 
; "INVALID  COMMAND  MODE" 

ERR8: 

EQU 

08H 

; ERROR  CODE  FOR 
; "DATA  BUFFER  SIZE  EXCEEDED 

FLAGS: 

EQU 

ODOH 

; STATUS  FLAGS  PORT 
;( SWITCH  FLAG) 

MSINTO: 

EQU 

OEOH 

; MASTER  INTERRUPT 
; CONTROLLER  -  A0=0 

SLINTO: 

EQU 

0E2H 

; SLAVE  INTERRUPT 
; CONTROLLER  -  A0=0 

TIMCTL : 

EQU 

0E5H 

{TIMING  CONTROLLER  CONTROL 
; AND  STATUS  PORT 

ATDSEL 

EQU 

0F8H 

{PORT  FOR  SELECTING  ONE 
; OF  SIXTEEN  A/D  INPUTS 

ATDCVT 

EQU 

0F9H 

{PORT  FOR  STARTING  AN 
; A/D  CONVERSION 

ATDSTS 

EQU 

0F9H 

;PORT  FOR  TESTING  FOR 
{END  OF  CONVERSION 

ATDHI 

• 

9 

EQU 

OFBH 

{PORT  FOR  READING  HI 
{BYTE  OF  A/D  CONVERTOR 

9 

9 

TASK  01 

OUTPUT 

TSKOIO: 

JR 

OMODIO 

{MODE  ”00"  ENTRY  POINT 

9 

JR 

0M0D1 1 

{MODE  "01"  ENTRY  POINT 

9 

JR 

0M0D12 

{MODE  "10"  ENTRY  POINT 

9 


JR 

JOBCMP 

OMODIO : 

CALL 

JOBOIO 

« 

JR 

JOBRET 

0M0D1 1 : 

LD 

DE.DATOUT 

JR 

GTJB10 

0M0D12: 

LD 

DE.DCHOUT 

GTJB10: 

CALL 

SBUFDF 

LD 

HL, JOBOIC 

1 

JP 

DOJOBO 

9 

9 

TASK 

01 

INPUT 

TSK01I: 

JR 

IMODIO 

9 

JR 

IM0D1 1 

9 

JR 

IM0D12 

9 

JR 

JOBCMP 

IM0D10: 

CALL 

JOBOII 

• 

JR 

JOBRET 

IM0D1 1 : 

LD 

DE.DATINP 

JR 

GTJB1I 

iMODI 2 : 

LD 

DE.DCHINP 

GTJB1 1  .• 

CALL 

SBUFDF 

LD 

HL, JOBOII 

• 

9 

JP 

DOJOBI 

9 

• 

9 

• 

TASK 

02 

OUTPUT 

TSK020 : 

JR 

OMODEO 

9 

JR 

0M0DE1 

9 

JR 

0M0DE2 

0M0DE3: 

JR 

JOBCMP 

OMODEO : 

CALL 

J0B020 

; MODE  ”11"  ENTRY  POINT 

; INVOKE  THE  OUTPUT  JOB 
; TAKEN  FOR  TASK  RETURN 

;GET  ADDRESS  OF  MODE  "01" 

; OUTPUT  DATA  HANDLER 
; TAKEN  TO  CONTINUE  TASK 
; SET  UP 

;GET  ADDRESS  OF  MODE  "10" 

; OUTPUT  DATA  HANDLER 
;  SET  BUFFER  DEFAULTS 
;GET  JOB  ADDRESS 
; LET  THE  CHOPS  DO  THE  WORK 


MODE  "00"  ENTRY  POINT 

MODE  "01"  ENTRY  POINT 

MODE  "10"  ENTRY  POINT 

MODE  "11"  ENTRY  POINT 

INVOKE  THE  INPUT  JOB 
TAKEN  FOR  TASK  RETURN 

GET  ADDRESS  OF  MODE  "01" 
INPUT  DATA  HANDLER 
TAKEN  TO  CONTINUE  TASK 
SET  UP 

GET  ADDRESS  OF  MODE  "10" 

INPUT  DATA  HANDLER 

SET  BUFFER  DEFAULTS 

GET  JOB  ADDRESS 

LET  THE  CHOPS  DO  THE  WORK 


; MODE  "00"  ENTRY  POINT 
; MODE  "01"  ENTRY  POINT 
; MODE  "10"  ENTRY  POINT 
;MODE  "11"  ENTRY  POINT 
,-INVOKE  THE  OUTPUT  JOB 
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JR 

JOBRET 

0M0DE1 :  LD 

DE.DATOUT 

JR 

GTJB20 

0M0DE2 :  LD 

DE,DCHOUT 

GTJB20:  CALL 

LD 

JP 

9 

SBUFDF 

HL, J0B020 
DOJOBO 

;  TASK  02 

INPUT 

TSK02I :  JR 

IMODEO 

JR 

IM0DE1 

JR 

IM0DE2 

IMODE3:  JR 

JOBCMP 

IMODE1:  LD 

DE,DATINP 

JR 

GTJB2I 

• 

IM0DE2 :  LD 

DE,DCHINP 

GTJB2I :  CALL 

LD 

JP 

i 

SBUFDF 

HL, J0B02I 
DOJOBI 

IMODEO :  CALL 
JOBRET:  JP 
JOBCMP :  JP 

9 

J0B02I 

C, ERROR 

TCMPLT 

;  JOB  01 

OUTPUT 

JOBOIO:  LD 

LD 

LD 

A,0FFH 
(  SWTFLG)  ,  A 

HL , INTATD 

LD 

( IVCTOR+1 ) , HL 

LD 

CALL 

HL , ( PRMBUF+4 ) 
SELATD 

CALL 

JR 

ENTJB1 

JOBEXT 

; TAKEN  FOR  TASK  RETURN 

;GET  ADDRESS  OF  MODE  "01" 

; OUTPUT  DATA  HANDLER 
; TAKEN  TO  CONTINUE  TASK 
;  SET  UP 

;GET  ADDRESS  OF  MODE  "10" 

; OUTPUT  DATA  HANDLER 
;  SET  BUFFER  DEFAULTS 
;GET  JOB  ADDRESS 
; LET  THE  CHOPS  DO  THE  WORK 


MODE  "00"  ENTRY  POINT 

MODE  "01"  ENTRY  POINT 

MODE  "10”  ENTRY  POINT 

MODE  "11"  ENTRY  POINT 

GET  ADDRESS  OF  MODE  "01" 
INPUT  DATA  HANDLER 
TAKEN  TO  CONTINUE  TASK 
SET  UP 

GET  ADDRESS  OF  TASK  "10" 

INPUT  DATA  HANDLER 

SET  BUFFER  DEFAULTS 

GET  JOB  ADDRESS 

LET  THE  CHOPS  DO  THE  WORK 


INVOKE  THE  OUTPUT  JOB 
TAKEN  IF  ERROR  DURING  JOB 
TAKEN  TO  WRAP  UP  TASK 


GET  SWITCH  ENABLE  FLAG 
SAVE  SWITCH  FLAG 
GET  ADDRESS  OF  A/D 
INTERRUPT  SERVICE  ROUTINE 
SET  ADDRESS  PORTION  OF 
INTERRUPT  VECTOR 
GET  A/D  CHANNEL  NUMBER 
SET  UP  A/D  CHANNEL  PORT 
ADDRESS 

INVOKE  OUTPUT  JOB 
TAKEN  TO  EXIT  JOB 


f 

• 

JOB  01 

INPUT 

JOBOII: 

LD 

A,  00H 

LD 

( SWTFLG) , A 

LD 

HL, INTDTA 

LD 

( IVCTOR+1 ) , HL 

LD 

HL  ,  ( PRMBUF+4 ) 

CALL 

SELDTA 

ENTJB1 : 

PUSH 

HL 

LD 

HL, (DATSTR) 

PUSH 

HL 

LD 

HL, (DATEND) 

LD 

RRA 

A,  L 

JR 

NC, SAVHL 

INC 

HL 

SAVHL : 

PUSH 

HL 

LD 

HL , ( PRMBUF+2) 

JR 

J0B01 

JOB  02 

OUTPUT 

J0B020 : 

LD 

A,  OFFH 

LD 

(SWTFLG)  ,  A 

LD 

HL, INTATD 

LD 

(IVCTOR+1 ),HL 

LD 

HL, ( PRMBUF+8) 

CALL 

SELATD 

CALL 

J0B02 

JOBEXT: 

RET 

C 

J 

LD 

(DATEND) , DE 

RET 

JOB  02 

INPUT 

J0B02I : 

LD 

A,  OOH 

LD 

(SWTFLG) , A 

LD 

HL, INTDTA 

LD 

( IVCTOR+1 ),HL 

GET  SWITCH  BYPASS  FLAG 
SAVE  SWITCH  FLAG 
GET  ADDRESS  OF  D/A 
INTERRUPT  SERVICE  ROUTINE 
SET  ADDRESS  PORTION  OF 
INTERRUPT  VECTOR 
GET  D/A  CHANNEL  NUMBER 
SET  UP  D/A  CHANNEL  PORT 
ADDRESS 

SAVE  I/O  PORT  ADDRESS 
GET  STARTING  ADDRESS  OF 
DATA  BUFFER 

SAVE  DATA  BUFFER  START 
GET  ENDING  ADDRESS  OF 
DATA  BUFFER 

GET  LO  BYTE  OF  END  ADDRESS 
LSB  TO  CARRY  FOR  ODD  TEST 
TAKEN  IF  ENDING  ADDRESS 
IS  EVEN 

INSURE  END  ADDRESS  IS  EVEN 
SAVE  DATA  BUFFER  END 
GET  TIMING  PARAMETER 
TAKEN  TO  CONTINUE  JOB 


GET  SWITCH  ENABLE  FLAG 
SAVE  SWITCH  FLAG 
GET  ADDRESS  OF  A/D 
INTERRUPT  SERVICE  ROUTINE 
SET  ADDRESS  PORTION  OF 
INTERRUPT  VECTOR 
GET  A/D  CHANNEL  NUMBER 
SET  UP  A/D  PORT  ADDRESS 
INVOKE  OUTPUT  JOB 
TAKEN  IF  ERROR  DURING  JOB 

SET  DATA  ENDING  ADDRESS 


GET  SWITCH,  BYPASS  FLAG 
SAVE  SWITCH  FLAG 
GET  ADDRESS  OF  D/A 
INTERRUPT  SERVICE  ROUTINE 
SET  ADDRESS  PORTION  OF 
INTERRUPT  VECTOR 
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LD 

HL , ( PRMBUF+8 ) 

{GET  D/A  CHANNEL  NUMBER 

CALL 

SELDTA 

; SET  UP  D/A  PORT  ADDRESS 

J0B02 :  PUSH 

HL 

; SAVE  I/O  PORT  ADDRESS 

LD 

DE, ( PRMBUF+2) 

;GET  PARAMETER  FOR  DATA 
; BUFFER  STARTING  WORD 

DEC 

DE 

; DECREMENT  ONCE  TO  ADJUST 
; SET  UP  AS  BYTE  COUNT 

SLA 

E 

; MULTIPLY  REMAINING  SIXTEEN 

RL 

D 

; BITS  BY  TWO  FOR  BYTES 

LD 

HL , ( DATSTR) 

;GET  ADDRESS  OF  BEGINNING 
; OF  DATA  BUFFER 

ADD 

HL.DE 

; ADD  STARTING  WORD  OFFSET 

PUSH 

HL 

; SAVE  DATA  BUFFER  STARTING 
; ADDRESS 

PUSH 

HL 

; SAVE  STARTING  ADDRESS 
; FOR  TRANSFER  TO  ‘BC'  REG. 

POP 

BC 

; PICK  UP  STARTING  ADDRESS 
;  IN  ’BC'  REGISTER 

LD 

HL, DATEND 

{GET  ADDRESS  OF  DATA  BUFFER 
; END  POINTER 

CALL 

BNDTST 

; CHECK  SO  BUFFER  LIMIT 
; NOT  EXCEEDED 

POP 

HL 

;GET  DATA  BUFFER  STARTING 
; ADDRESS  IN  ’ HL '  REGISTER 

POP 

DE 

; RESTORE  THE  STACK  IN  CASE 
;OF  ERROR  RETURN 

JP 

C, JOBERR 

; TAKEN  IF  STARTING  ADDRESS 
;  IS  PAST  DATA  BUFFER  END 

PUSH 

DE 

; SAVE  I/O  PORT  ADDRESS 

PUSH 

HL 

; SAVE  DATA  BUFFER  STARTING 
; ADDRESS 

LD 

DE , ( PRMBUF+4 ) 

;GET  NUMBER  OF  WORDS  TO 
; TRANSFER  PARAMETER 

DEC 

DE 

; DECREMENT  ONCE  TO  ADJUST 
;FOR  ADDRESSING  BYTES 

SLA 

E 

; MULTIPLY  REMAINING  SIXTEEN 

RL 

D 

;BITS  BY  TWO  FOR  BYTES 

ADD 

HL,  DE 

; ADD  DATA  LENGTH  TO  DATA 
; START  ADDRESS 

PUSH 

HL 

; SAVE  DATA  END  ADDRESS 

POP 

BC 

;  PICK  UP  ADDRESS  OF  DATA 
; END  IN  'BC'  REGISTER 

LD 

HL, DATEND 

;GET  ADDRESS  OF  DATA  BUFFER 
; END  POINTER 

CALL 

BNDTST 

; CHECK  TO  INSURE  DATA  BUFFER 
{BOUNDS  NOT  EXCEEDED 

POP 

HL 

;GET  DATA  START  ADDRESS 
;  IN  ’HL’  REGISTER 

POP 

DE 

{RESTORE  THE  STACK  IN  CASE 
{OF  ERROR 

JP 

C, JOBERR 

{TAKEN  IF  DATA  END  ADDRESS 
;IS  PAST  DATA  BUFFER  END 

PUSH 

DE 

{SAVE  I/O  PORT  ADDRESS  - 
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J0B01  : 


SWITCH: 


PUSH 

HL 

; SAVE  DATA  START  ADDRESS 

PUSH 

BC 

;  SAVE  DATA  END  ADDRESS 

LD 

HL, ( PRMBUF+6) 

;GET  TIMING  PARAMETER 

PUSH 

HL 

; SAVE  TIMING  PARAMETER 

LD 

A.OC3H 

;GET  JUMP  OP  CODE 

LD 

( IVCTOR) , A 

; PUT  JUMP  INSTRUCTION 
; AT  INTERRUPT  ADDRESS 

LD 

HL, MIOTBL 

;GET  ADDRESS  OF  MASTER 
; INTERRUPT  CONTROLLER  SET 
; UP  TABLE 

LD 

DE , USERAM 

;GET  ADDRESS  OF  THE  USER 
; RAM  SPACE 

LD 

BC, INTATD-MIOTBL 

;GET  SET  UP  TABLE  LENGTH 

LDIR 

; MOVE  TABLE  TO  USER  RAM 

EX 

DE,  HL 

; POINT  *  HL '  TO  TABLE  END 

POP 

DE 

;GET  TIMING  PARAMETER 

DEC 

HL 

; POSITION  TABLE  POINTER  TO 

DEC 

HL 

; ENTRY  FOR  TIMING  PARAMETER 

LD 

( HL) ,D 

; SAVE  HI  BYTE 

DEC 

HL 

; BUMP  TABLE  POINTER 

LD 

( HL) , E 

; SAVE  LO  BYTE 

LD 

B ,  04H 

;GET  COUNT  FOR  MASTER 
; INTERRUPT  CONTROLLER  SET  UP 

LD 

HL, USERAM 

; POINT  TO  TOP  OF  SET  UP  TABLE 

LD 

C , MSINTO 

; MASTER  INTERRUPT  CONTROLLER 
; PORT  ADDRESS 

OUTI 

; SET  UP  MASTER  CONTROLLER 

INC 

C 

;BUMP  PORT  ADDRESS 

OTIR 

; COMPLETE  MASTER  SET  UP 

LD 

B,  04H 

;GET  COUNT  FOR  SLAVE 

INC 

C 

; BUMP  PORT  ADDRESS  TO  SLAVE 

OUTI 

; SET  UP  SLAVE  FROM  TABLE 

INC 

C 

; BUMP  PORT  ADDRESS 

OTIR 

; COMPLETE  SLAVE  SET  UP 

LD 

B,  02H 

;GET  COUNT  FOR  TIMING 
; CONTROLLER  SET  UP 

LD 

C , TIMCTL 

;GET  TIMING  CONTROLLER 
; PO R T  ADDRESS 

OTIR 

; SET  UP  TIMING  CONTROLLER 

LD 

B,  04H 

;GET  NEXT  SET  UP  COUNT 

DEC 

C 

•.DECREASE  PORT  ADDRESS 

OTIR 

; CONTINUE  SET  UP  FOR  TABLE 

INC 

C 

; BUMP  PORT  ADDRESS 

OUTI 

; COMPLETE  TIMING  CONTROLLER 
; SET  UP 

POP 

DE 

;GET  DATA  END  ADDRESS 

POP 

HL 

;GET  DATA  START  ADDRESS 

POP 

BC 

;GET  I/O  PORT  ADDRESS 

IM 

1 

; SET  8080  INTERRUPT  MODE 

LD 

A , ( SWTFLG) 

;GET  DECISION  SWITCH  FLAG 

OR 

A 

; SET  CONDITION  CODES 

JR 

Z, SRTINT 

; TAKEN  IF  SWITCH  NOT  NEEDED 

IN 

A, FLAGS 

; INPUT  NOVA  FLAGS 

AND 

SWTMSK 

; EXTRACT  THE  SWITCH  DATA 

1 24 


SRTINT : 
HILOOP: 


LOLOOP: 


JOBERR: 


SELATD : 


JR 

NZ, SWITCH 

; TAKEN  IF  SWITCH  NOT 

; PRESSED 

El 

; INTERRUPTS  OK  NOW 

LD 

A,  H 

;GET  HI  BYTE  OF  DATA 

; ADDRESS 

CP 

D 

; CHECK  IF  AT  END  YET 

JR 

C, HILOOP 

; TAKEN  IF  NOT  ON  LAST 

; PORTION 

LD 

A,  L 

;GET  LO  BYTE  OF  DATA  ADDRESS 

CP 

E 

; CHECK  IF  LAST  BYTE  CONVERTED 

JR 

C, LOLOOP 

; TAKEN  IF  NOT  FINISHED 

DI 

; FINISHED  WITH  INTERRUPTS 

LD 

A, OFFH 

;GET  TIMER  RESET  CODE 

OUT 

( TIMCTL) , A 

; RESET  THE  TIMING  CONTROLLER 

RET 

LD 

E , ERR8 

;GET  ERROR  CODE  FOR 

; "DATA  BUFFER  SIZE  EXCEEDED" 

RET 

THE 

FOLLOWING  SUBROUTINE  SELECTS  ONE  OF  SIXTEEN 

OF 

THE  ANALOG  TO 

DIGITAL  CONVERTER.  THE  DESIRED 

CHANNEL  IS  PASSED 

IN 

THE  LEAST  SIGNIFICANT  FOUR 

BITS  OF  THE  »L*  REGISTER.  AFTER  SELECTING  THE 

CHANNEL,  THE  ROUTINE 

RETURNS  WITH  THE  PORT  ADDRESS 

OF 

THE  HIGH  BYTE 

OF 

A/D  DATA  IN  THE  *L*  REGISTER. 

THE 

•H'  REGISTER 

IS 

ZEROED  ON  RETURN. 

LD 

A,  L 

;GET  A/D  CHANNEL  NUMBER 

OUT 

( ATDSEL) , A 

; SET  A/D  CHANNEL  NUMBER 

LD 

HL , ATDHI 

; PUT  ADDRESS  OF  A/D  HI  DATA 

;BYTE  IN  'L'  REGISTER 


RET 


THE  FOLLOWING  SUBROUTINE  GENERATES  THE  PROPER  DIGITAL 
TO  ANALOG  CONVERTER  PORT  ADDRESS  BASED  ON  THE  NUMBER 
PASSED  IN  THE  LEAST  SIGNIFICANT  TWO  BITS  OF  THE  '  L' 
REGISTER.  THE  GENERATED  PORT  ADDRESS  IS  RETURNED  IN 
THE  'L'  REGISTER. 


THE  MAPPING  BETWEEN  THE  D/A  PORT  ADDRESSES  AND  THE 
NUMBER  THAT  IS  PASSED  DOES  NOT  DIRECTLY  CORRESPOND 
TO  THE  NUMBERING  OF  THE  PORT  ADDRESSES  IN  THE 
DOCUMENTATION  FOR  THE  D/A  CONVERTER.  TO  SIMPLIFY 
THIS  ROUTINE  THE  FOLLOWING  MAPPING  HAS  BEEN  USED: 


CHOPS 

1 

2 

3 

4 


DOCUMENTED 

B 

C 

D 

A 
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SELDTA : 

LD 

A,  L 

GET  D/A  CONVERTER  NUMBER 

SLA 

A 

MULTIPLY  BY  TWO 

AND 

07H 

GET  LOWER  THREE  BITS 

OR 

OFOH 

SET  FOUR  HIGHER  BITS 
GENERATE  PORT  ADDRESS 

TO 

LD 

L,  A 

PUT  IN  'L'  REGISTER 

RET 

THE 

FOLLOWING  ROUTINE  PROVIDES  THE  ACKNOWLEDGE 

TO 

MASTER  AND  SLAVE  INTERRUPT  CONTROLLERS. 

INTACK: 

LD 

A ,  OOCH 

CONTROLLER  OCW3  WITH 
BIT  SET 

POLL 

OUT 

(MSINTO) , A 

POLL  MASTER  INTERRUPT 
CONTROLLER 

OUT 

(SLINTO) ,A 

POLL  SLAVE  INTERRUPT 
CONTROLLER 

IN 

A, (MSINTO) 

ACKNOWLEDGE  INTERRUPT 
THE  MASTER 

AT 

IN 

A, ( SLINTO) 

ACKNOWLEDGE  INTERRUPT 
THE  SLAVE 

AT 

RET 

THE  FOLLOWING  TABLE  CONTAINS  THE  VALUES  NEEDED  TO  SET 
UP  THE  INTERRUPT  AND  TIMING  CONTROLLERS.  THE  TABLE 
CONTENTS  ARE  TRANSFERRED  TO  THE  CHOPS  USER  RAM  AREA 
AND  THE  TIMING  PARAMETER  IS  INSERTED  IN  THE  TABLE  BY 
THE  ROUTINES  WITHIN  THE  TASK.  THE  TABLE  VALUES  ARE 
THEN  TRANSFERRED  TO  THE  PROPER  REGISTERS  OF  THE 
RESPECTIVE  CONTROLLER  TO  COMPLETE  THE  SET  UP.  THE 
DOCUMENTATION  FOR  EACH  OF  THE  CONTROLLERS  SHOULD  BE 
REFERENCED  TO  OBTAIN  A  DETAILED  DESCRIPTION  OF  THE 
CONTROLLERS'  OPERATION  AND  SET  UP  VALUES. 


MIOTBL : 

DB 

01 1  H 

ICW1 

— 

A5,A6,A7  =  0 

EDGE  TRIGGERED 
INPUT  MODE 

- 

EIGHT  BYTE  ENTRIES 
IN  INTERRUPT  TABLE 

MI1TBL: 

DB 

OOOH 

ICW2 

- 

A8  THRU  A15  =  0 

DB 

002H 

ICW3 

- 

SELECT  MASTER  MODE 

DB 

00  EH 

ICWU 

- 

NON-SPECIAL  FULLY 
NESTED  MODE 

- 

MASTER  ID 

— 

AUTO  END  OF 
INTERRUPT 

SLOTBL : 

DB 

01  1H 

ICW1 

- 

A5,A6,A7  =  0 

— 

EDGE  TRIGGERED 
INPUT  MODE 

EIGHT  BYTE  ENTRIES 
IN  INTERRUPT  TABLE 
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TCRTBL : 


COUNT: 


INTATD : 


ATDTST : 


DB 

OOOH 

ICW2 

-  A8  THRU  A15 

=  0 

DB 

00  1 H 

ICW3 

-  SELECT  SLAVE 

MODE 

DB 

OOAH 

ICW4 

-  NON-SPECIAL 
NESTED  MODE 

-  SLAVE  ID 

-  AUTO  END  OF 

FULLY 

INTERRUPT 

DB 

OFFH 

TIMING 

CONTROLLER  MASTER 

RESET 

CODE 

DB 

003H 

DATA  POINTER  REGISTER 

#3 

DW 

0B22H 

COUNTER  MODE  WITH 

TC  TOGGLE 
COUNT  DOWN 
BINARY  COUNT 
REPETITIVELY 
4  MHZ  TIME  BASE 


DW 

OOOOH 

; DIVISOR  FOR  LOAD  REGISTER 
; TIMING  PARAMETER  GOES  HERE 

DB 

064H 

; LOAD  AND  ARM  COUNTER  #3 

THE  FOLLOWING  ROUTINE  PROVIDES  THE  INTERRUPT  SERVICE 
FOR  THE  ANALOG  TO  DIGITAL  CONVERTER.  THE  ROUTINE 
INITIATES  A  CONVERSION,  ACKNOWLEDGES  THE  INTERRUPT 
COLLECTS  THE  DATA  AND  STORES  IT  IN  THE  BUFFER.  IT 
REQUIRES  THE  '  HL '  REGISTER  TO  BE  SET  TO  THE  ADDRESS 
IN  WHICH  THE  DATA  IS  TO  BE  PLACED,  THE  *C'  REGISTER 
MUST  CONTAIN  THE  PORT  ADDRESS  OF  THE  HIGH  DATA  BYTE. 
THE  'HL'  REGISTER  WILL  BE  INCREMENTED  BY  TWO  BEFORE 
THE  ROUTINE  RETURNS.  THE  OTHER  REGISTERS  ARE  NOT 
CHANGED. 


OUT 

DI 

( ATDCVT) , A 

PUSH 

AF 

CALL 

INTACK 

IN 

RRA 

A, ( ATDSTS) 

JP 

NC, ATDTST 

INI 

DEC 

C 

INI 

INC 

C 

JP 

INTRET 

START  A  CONVERSION 
DISABLE  POSSIBLE  INTERRUPT 
SAVE  ACCUMULATOR  AND  STATUS 
ACKNOWLEDGE  INTERRUPT 
GET  A/D  STATUS 
READY  FLAG  TO  CARRY 
TAKEN  IF  CONVERSION 
NOT  COMPLETE 

GET  AND  STORE  HI  DATA  BYTE 
SET  PORT  ADDRESS  TO  LO 
DATA  BYTE 

GET  AND  STORE  LO  DATA  BYTE 
SET  PORT  ADDRESS  TO  HI 
DATA  BYTE 
TAKEN  TO  COMPLETE 
INTERRUPT  SERVICE 


THE  FOLLOWING  ROUTINE  PROVIDES  THE  INTERRUPT  SERVICE 
FOR  THE  DIGITAL  TO  ANALOG  CONVERTER.  THE  ROUTINE 
ACKNOWLEDGES  THE  INTERRUPT  AND  RETRIEVES  THE  DATA 
FROM  THE  BUFFER.  IT  REQUIRES  THE  'HL'  REGISTER  TO 
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INTDTA: 


INTRET: 


i 

t 


BE  SET  TO  THE  ADDRESS  IN  WHICH  THE  DATA  IS  STORED, 
THE  »C*  REGISTER  MUST  CONTAIN  THE  PORT  ADDRESS  OF 
THE  HIGH  DATA  BYTE.  THE  ' HL 1  REGISTER  WILL  BE 
INCREMENTED  BY  TWO  BEFORE  THE  ROUTINE  RETURNS. 

THE  OTHER  REGISTERS  ARE  NOT  CHANGED. 


DI 

PUSH 

CALL 

OUTI 

INC 

AF 

INTACK 

C 

OUTI 

DEC 

C 

LD 

A ,  020H 

OUT 

OUT 

POP 

( MSINTO )  ,  A 
(SLINTO)  ,  A 
AF 

El 

RETI 

END 

DISABLE  POSSIBLE  INTERRUPT 
SAVE  ACCUMULATOR  AND  STATUS 
ACKNOWLEDGE  INTERRUPT 
SET  HI  DATA  BYTE  IN  D/A 
SET  PORT  ADDRESS  TO 
LO  DATA  BYTE 
SET-LO  DATA  BYTE  IN  D/A 
SET  PORT  ADDRESS  TO 
HI  DATA  BYTE 

GET  0CW2  WITH  NON-SPECIFIC 
END  OF  INTERRUPT 
CLEAR  INTERRUPT  ON  MASTER 
CLEAR  INTERRUPT  ON  SLAVE 
RESTORE  ACCUMULATOR  AND 
STATUS 

OK  FOR  MORE  INTERRUPTS 


;  END  OF  TASKS  ONE  AND  TWO 
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xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 


NOVA/CROMEMCO 
CHANNEL  OPERATING  SYSTEM 
CHOPS 
TASK  NUMBER  THREE 

VIDEO  DATA  DISPLAY,  COLLECTION,  AND  TRANSFER) 


VERSION  1 .0 


WRITTEN  BY 

CAPT  GEORGE  C.  BEASLEY,  JR.,  USAF 
MARCH  1981 


xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 


THE  FOLLOWING  TASK  PROVIDES  THE  CAPABILITY  TO  COLLECT 
AND  DISPLAY  VIDEO  INFORMATION.  THE  INFORMATION  THAT 
IS  DISPLAYED  MAY  EITHER  COME  FROM  THE  NOVA  OR  FROM 
AN  EXTERNAL  CAMERA  CONNECTED  TO  THE  SYSTEM. 

SELECTING  INPUT  OR  OUTPUT  WITH  THE  VARIOUS  DATA 
TRANSFER  MODES,  PROVIDES  THESE  POSSIBILITIES  OF  THE 
SOURCE  OF  THE  DISPLAYED  VIDEO  DATA. 

UTILIZATION  OF  THIS  TASK  REQUIRES  THAT  THE  THREE 
TECMAR  VIDEO  DIGITIZER  BOARDS  WITH  SUITABLE  VIDEO 
MONITOR  AND  CAMERA  CONNECTED  BE  PROPERLY  INSTALLED 
IN  THE  CROMEMCO. 

THIS  TASK  REQUIRES  ONE  PARAMETER  TO  BE  PASSED  TO  IT. 
THIS  PARAMETER  REPRESENTS  THE  APPROXIMATE  TIME  IN 
SECONDS  TO  DISPLAY  THE  VIDEO  INFORMATION  BEFORE 
COLLECTION  AND/OR  TRANSFER  TO~THE  NOVA  OR  AFTER 
TRANSFER  FROM  THE  NOVA. 


THE  FOLLOWING  EXTERNAL  ROUTINES  AND  VARIABLES  ARE 
AVAILABLE  FOR  USE  BY  THIS  TASK. 

EXT  TCMPLT, ERROR, DATOUT, DCHOUT, DATINP, DCHINP 
EXT  DOJOBO, DOJOBI , LOMEM,HIMEM,DATSTR,DATEND 

EXT  BNDTST , PRMBUF 


129 


> 


i 


THE  FOLLOWING  DEFINITION  ALLOWS  THE  COMMAND  TABLE 
TO  PICK  UP  THE  TASK  ADDRESS  DURING  LINKING.  THESE 
ENTRY  POINT  ADDRESSES  MUST  BE  SPECIFIED  IN  THIS 
MANNER  TO  ALLOW  THE  TASK  ADDRESS  TO  BE  INCLUDED  IN 
THE  COMMAND  TABLE. 


ENTRY  TSK030, TSK03I 


t 


IVCTOR : 

EQU 

0038H 

ERR6 

EQU 

06H 

ERR8: 

EQU 

08H 

VIDCTL : 

EQU 

OFFH 

9 

9 

9 

OUTPUT 

TASK  03 

TSK030: 

JR 

OMODEO 

9 

JR 

0M0DE1 

9 

JR 

0M0DE2 

9 

JP 

TCMPLT 

OMODEO : 

CALL 

SETBUF 

JR 

C, JOBERR 

CALL 

JOB030 

JR 

JOBRET 

0M0DE1  : 

LD 

DE,DATOUT 

JR 

GTOJOB 

0M0DE2 : 

LD 

DE , DCHOUT 

GTOJOB : 

CALL 

SETBUF 

JR 

C, JOBERR 

LD 

HL, J0B030 

9 

JP 

DOJOBO 

9 

9 

INPUT 

TASK  03 

TSK03I: 

JR 

IMODEO 

! 

JR 

IM0DE1 

ADDRESS  FOR  INTERRUPT  VECTOR 
JUMP  STORAGE 
ERROR  CODE  FOR 
"INVALID  COMMAND  MODE" 

ERROR  CODE  FOR 
"DATA  BUFFER  SIZE  EXCEEDED" 
TIMING  CONTROLLER 
CONTROL  AND  STATUS  PORT 


; MODE  "00"  ENTRY  POINT 

; MODE  "01"  ENTRY  POINT 

; MODE  "10"  ENTRY  POINT 

; MODE  "11"  ENTRY  POINT 

; SET  UP  BUFFER  ADDRESSES 
; TAKEN  IF  ERROR  IN  SETTING 
; UP  VIDEO  DATA  BUFFER 
;  INVOKE  THE  OUTPUT  JOB 
; TAKEN  FOR  ORDERLY  RETURN 
;  TO  THE  CHOPS 

;GET  ADDRESS  OF  MODE  "01" 

;  OUTPUT  DATA  HANDLER 
;TAKEN  TO  CONTINUE  TASK 

;GET  ADDRESS  OF  MODE  "10" 

;  OUTPUT  DATA  HANDLER 
;  SET  UP  BUFFER  ADDRESSES 
;  TAKEN  IF  ERROR  IN  SETTING 
;  UP  VIDEO  DATA  BUFFER 
;GET  ADDRESS  OF  OUTPUT  JOB 
;  LET  THE  CHOPS  DO  THE  WORK 


; MODE  "00"  ENTRY  POINT 
; MODE  "01"  ENTRY  POINT 
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JR 

IM0DE2 

; MODE  "10"  ENTRY  POINT 

! 

jp 

TCMPLT 

; MODE  "11"  ENTRY  POINT 

IMODE1 :  LD 

DE, DATINP 

;GET  ADDRESS  OF  MODE  "01" 

; INPUT  DATA  HANDLER 

JR 

GTIJOB 

; TAKEN  TO  CONTINUE  TASK 

IM0DE2 :  LD 

DE,DCHINP 

;GET  ADDRESS  OF  MODE  "10" 

; INPUT  DATA  HANDLER 

GTIJOB :  CALL 

SETBUF 

; SET  UP  BUFFER  ADDRESSES 

JR 

C, JOBERR 

; TAKEN  IF  ERROR  IN  SETTING 
,*UP  VIDEO  DATA  BUFFER 

LD 

HL, JOB03I 

;GET  ADDRESS  OF  INPUT  JOB 

JP 

DOJOBI 

;LET  THE  CHOPS  DO  THE  WORK 

IMODEO:  LD 

BC,  (LOMEM) 

;GET  ADDRESS  OF  LOWEST  DATA 
; BUFFER  LOCATION 

LD 

HL , ( DATSTR ) 

;GET  ADDRESS  OF  FIRST  DATA 
; WORD  IN  BUFFER 

CALL 

BNDTST 

; CHECK  FOR  PROPER  PICTURE 
; STARTING  ADDRESS 

JR 

C, JOBERR 

; TAKEN  IF  BEGINNING  OF 
; PICTURE  NOT  POSITIONED 
; PROPERLY  IN  BUFFER 

CALL 

JOB03I 

; DISPLAY  INPUT  PICTURE 

JOBRET:  JP 

NC, TCMPLT 

; TAKEN  IF  NO  JOB  ERROR 

JOBERR:  LD 

E.ERR8 

;GET  ERROR  CODE  FOR 
; "DATA  BUFFER  SIZE  EXCEEDED 

JP 

9 

ERROR 

; TAKEN  TO  HANDLE  ERROR 

;  THE 

FOLLOWING  JOB  SETS 

UP  THE  VIDEO  DATA  BUFFER, 

STARTS  THE  A/D  AND  D/A  OF  THE  VIDEO  DIGITIZER 
(DISPLAYS  THE  DIGITIZED  IMAGE  WHILE  COLLECTING), 
AND  DELAYS  FOR  A  SPECIFIED  TIME. 


J0B03O:  LD 

HL, (DATSTR) 

;GET  VIDEO  DATA  BUFFER 
; STARTING  ADDRESS 

CALL 

SETVID 

{GENERATE  DIGITIZER  COMMAND 

RET 

C 

{TAKEN  IF  ERROR  IN  COMMAND 

OR 

OCOH 

{SET  COMMAND  BYTE  TO  COLLECT 

OUT 

( VIDCTL) , A 

{COMMAND  DIGITIZER 

CALL 

DISVID 

{DISPLAY  THE  VIDEO  IMAGE 

SCF 

{CLEAR  CARRY  FLAG  FOR  NO 

CCF 

{ERROR  RETURN  TO  THE  CHOPS 

RET 

THE  FOLLOWING  JOB  SETS  UP  THE  VIDEO  DATA  BUFFER, 
STARTS  THE  D/A  OF  THE  VIDEO  DIGITIZER  AND  DELAYS 
FOR  A  SPECIFIED  TIME. 
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J0B03I: 

LD 

HL , ( DATSTR ) 

;GET  VIDEO  DATA  BUFFER 
STARTING  ADDRESS 

CALL 

SETVID 

[GENERATE  DIGITIZER  COMMAND 

RET 

C 

[TAKEN  IF  ERROR  IN  COMMAND 

9 

OR 

080H 

SET  COMMAND  BYTE  TO  DISPLAY 

OUT 

(VIDCTL) , A 

COMMAND  DIGITIZER 

DISVID: 

LD 

HL , ( PRMBUF+2) 

GET  TIMING  PARAMETER 

TLOOP : 

LD 

BC, 1 100H 

SET  UP  COUNT  FOR  ONE 

SECOND  TIMING  LOOP 

TLOOP1 : 

DEC 

C 

LOOP  FOR  APPROXIMATELY 

JR 

NZ, TLOOP1 

DEC 

B 

[ONE  SECOND 

JR 

NZ, TLOOP1 

DEC 

HL 

DECREMENT  SECOND  COUNT 

LD 

A,  L 

GET  LO  BYTE  OF  TIME 

CP 

OOH 

CHECK  FOR  ZERO 

JR 

NZ, TLOOP 

TAKEN  TO  WAIT  A  SECOND 

LD 

A,  H 

GET  HI  BYTE  OF  TIME 

CP 

OOH 

CHECK  FOR  ZERO 

JR 

NZ, TLOOP 

TAKEN  FOR  ANOTHER  SECOND 

XOR 

A 

SET  DIGITIZER  STOP  COMMAND 

OUT 

(VIDCTL) , A 

COMMAND  DIGITIZER 

i 

RET 

• 

9 

9 

THE  FOLLOWING  SUBROUTINE 

SETS  UP  THE  VIDEO  DATA 

9 

BUFFER 

AND  INSURES  THAT 

THERE  IS  ENOUGH  MEMORY 

9 

AVAILABLE  IN  THE  BUFFER 

TO  DISPLAY  A  COMPLETE 

• 

9 

VIDEO 

IMAGE.  IF  THERE  IS  NOT  ENOUGH  MEMORY  THIS 

9 

ROUTINE  WILL  RETURN  WITH  THE  CARRY  FLAG  SET. 

SETBUF : 

PUSH 

DE 

SAVE  THE  'DE'  REGISTER 

LD 

HL , ( LOMEM) 

GET  LOWEST  DATA  BUFFER 
STARTING  ADDRESS 

LD 

(DATSTR) ,HL 

SET  DATA  START  ADDRESS 

LD 

DE , 07FFFH 

GET  VIDEO  DATA  LENGTH 

ADD 

HL,DE 

FIND  END  ADDRESS 

PUSH 

HL 

TRANSFER  ’  HL '  REGISTER 

POP 

BC 

TO  THE  'BC'  REGISTER 

LD 

HL , ( HIMEM) 

GET  HIGHEST  DATA  BUFFER 
ENDING  ADDRESS 

CALL 

BNDTST 

CHECK  FOR  ENOUGH  ROOM 

POP 

DE 

RESTORE  OLD  'DE'  REGISTER 

RET 

C 

CARRY  SET  ON  ERROR 

LD 

(DATEND) , BC 

SAVE  DATA  END  ADDRESS 

RET 

THE  FOLLOWING  ROUTINE  GENERATES  THE  ADDRESS  PORTION 
OF  THE  DIGITIZER  COMMAND  BYTE.  THIS  ROUTINE  USES 
THE  ADDRESS  PASSED  IN  THE  'HL'  REGISTER  TO  SET  THE 
PROPER  BITS  OF  THE  COMMAND  BYTE  SO  THE  DIGITIZER 
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WILL  KNOW  WHERE  IN  MEMORY  THE  VIDEO  DATA  SHOULD  BE. 
THIS  ROUTINE  ALSO  CHECKS  TO  INSURE  THAT  THE  VIDEO 
DATA  STARTS  ON  AN  EVEN  PAGE  BOUNDARY.  THIS  IS  AN 
ABSOLUTE  CONSTRAINT  BASED  ON  THE  LIMITATIONS  OF  THE 
DIGITIZER.  IF  VIDEO  DATA  DOES  NOT  START  ON  AN  EVEN 


BOUNDARY  THIS  ROUTINE 
SET. 


SETVID : 

LD 

A,L 

OR 

A 

JR 

1, PAGEOK 

SCF 

RET 

PAGEOK: 

LD 

A,  H 

SRL 

A 

SRL 

A 

RET 

! 

» 

END 

RETURNS  WITH  THE  CARRY  FLAG 


GET  LO  BYTE  OF  DATA  ADDRESS 
SET  CONDITION  CODES 
TAKEN  IF  EVEN  PAGE  BOUNDARY 
SET  CARRY  FLAG  FOR  ERROR 


GET  HI  BYTE  OF  ADDRESS 
PROPERLY  POSITION  BITS  IN 
THE  COMMAND  BYTE 
CARRY  WILL  BE  CLEAR  IF 
VALID  STARTING  ADDRESS 


;  END  OF  TASK  03 
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CHANNEL  IS  A  FORTRAN  SUBROUTINE.  THE  FOLLOWING 
PROCEDURE  MUST  BE  FOLLOWED  TO  CREATE  OBJECT  CODE  WHICH 
INCLUDES  CHANNEL.  CHANNEL  MUST  BE  COMPILED  USING  THE  DG 
FORTRAN  IV  COMPILER  AND  THEN  THE  RELOCATABLE  BINARY  CODE 
MUST  BE  LINKED  WITH  THE  RELOCATABLE  CODE  OF  SANDS, 
CANDR,  DCHTX ,  DCHRX ,  AND  FORT. LB.  THIS  SHOULD  BE  DONE 
USING  RLDR.  CHANNEL  MUST  BE  CALLED  AS  FOLLOWS: 

CALL  CHANNEL(ITASK,  DIR,  MODE,  PCNT,  DCOUNT,  FILENAM, 
DCHBLKS,  DARRAY,  PARRAY,  ERROR,  SYSERR) 

NOTE:  ALL  VARIABLES  AND  ARRAYS  LISTED  BELOW  ARE 

INTEGER. 

ITASK-  PASSED  TO  CHANNEL.  THIS  IS  THE  NUMBER  OF 
THE  TASK  WHICH  IS  TO  BE  EXECUTED  BY  THE  I/O 
CHANNEL. 

DIR-  PASSED  TO  CHANNEL.  THIS  IS  THE  DIRECTION 

IN  WHICH  ANY  DATA  WILL  FLOW  WHEN  THE  TASK 
IS  EXECUTED. 

MODE-  PASSED  TO  CHANNEL.  THIS  SPECIFIES  THE  MODE 
OF  THE  TASK  TO  BE  EXECUTED. 

PCNT-  PASSED  TO  CHANNEL.  THIS  SPECIFIES  THE 
NUMBER  OF  PARAMETERS  TO  BE  PASSED  TO  THE 
I/O  CHANNEL. 

RETURN  FROM  CHANNEL.  SHOULD  AN  ERROR  OCCUR 
DURING  THE  TRANSFER  OF  PARAMETERS,  THE 
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DCOUNT- 


FILENAM- 


DCHBLKS- 


DARRAY- 


PARRAY- 


ERROR- 


NUMBER  OF  THE  PARAMETER  BEING  PASSED  IS 
RETURNED  IN  THIS  ARGUMENT. 

PASSED  TO  CHANNEL.  THIS  SPECIFIES  THE 
NUMBER  OF  DATA  WORDS  TO  BE  TRANSFERRED 
DURING  A  MODE  1  TASK  AND  THE  NUMBER  OF  DISK 
BLOCKS  IN  EACH  DATA  CHANNEL  (DCH)  BLOCK  FOR 
A  MODE  2  TASK. 

RETURNED  FROM  CHANNEL.  SHOULD  AN  ERROR 
OCCUR  DURING  THE  TRANSFER  OF  DATA  FOR  A 
MODE  1  TASK,  THE  NUMBER  OF  THE  DATA  WORD 
BEING  PASSED  AT  THE  TIME  IS  RETURNED  IN 
THIS  ARGUMENT. 

PASSED  TO  CHANNEL.  THIS  IS  A  CHARACTER 
ARRAY  WHICH  CONTAINS  THE  NAME  OF  THE  FILE 
INVOLVED  IN  A  MODE  2  TASK.  THE  ARRAY  CAN 
CONTAIN  UP  TO  U  CHARACTERS  (INCLUDING 
PUNCTUATION)  AND  THE  DIRECTORY  MAY  BE  PUT 
ON  AS  A  PREFIX. 

PASSED  TO  CHANNEL.  IF  THIS  ARGUMENT  IS 
ZERO  FOR  AN  INPUT  MODE  2  TASK,  A  RANDOM 
FILE  IS  CREATED.  IF  IT  CONTAINS  AN  INTEGER 
OTHER  THAN  ZERO,  A  CONTIGUOUS  FILE  OF  THAT 
SIZE  (IN  BLOCKS)  WILL  BE  CREATED. 

PASSED  TO  CHANNEL.  THIS  ARRAY  CONTAINS  THE 
DATA  TO  BE  OUTPUT  TO  A  MODE  1  TASK.  THE 
NUMBER  OF  DATA  WORDS  CONTAINED  IN  THE  ARRAY 
MUST  AGREE  WITH  DCOUNT.  THE  MEMORY  FOR 
THIS  ARRAY  IS  DYNAMICALLY  ALLOCATED  AND  IS 
THEREFORE  SUBJECT  TO  THE  LIMITATIONS 
ASSOCIATED  WITH  THIS  PROCEDURE. 

RETURNED  FROM  CHANNEL.  THIS  ARRAY  WILL 
CONTAIN  THE  DATA  RECEIVED  DURING  A  MODE  1 
TASK.  THE  SAME  MEMORY  CONSTRAINTS  AS  ABOVE 
ALSO  APPLY. 

PASSED  TO  CHANNEL.  THIS  ARRAY  CONTAINS  THE 
PARAMETERS  TO  BE  PASSED  TO  THE  I/O  CHANNEL. 
THE  NUMBER  OF  PARAMETERS  MUST  AGREE  WITH 
PCOUNT. 

RETURNED  FROM  CHANNEL.  SHOULD  AN  ERROR 
OCCUR  DURING  THE  I/O  TRANSACTIONS  IT  WILL 
BE  RETURNED  HERE.  ERROR  IS  DIVIDED  INTO 
TWO  FIELDS.  THE  LEAST  SIGNIFICANT  BYTE 
WILL  CONTAIN  THE  ERROR  RETURNED  BY  THE  I/O 
CHANNEL.  THE  MOST  SIGNIFICANT  BYTE  WILL 
CONTAIN  THE  CHANNEL  ERROR,  IF  ANY.  IF  NO 
ERROR  OCCURES  A  ZERO  WILL  BE  RETURNED. 
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SYSERR-  RETURNED  FROM  CHANNEL.  ANY  SYSTEM  ERROR 
WHICH  OCCURS  DURING  AN  I/O  TRANSACTION  WILL 
BE  RETURNED  HERE.  IT  WILL  BE  IN  THE  FORM 

OF  A  FORTRAN  SYSTEM  ERROR.  A  ONE  WILL  BE 

RETURNED  IF  NO  ERROR  OCCURS.  ALL  SYSTEM 
ERRORS  WILL  HAVE  AN  ASSOCIATED  CHANNEL 

ERROR  EXCEPT  AN  END  OF  FILE  ERROR  (9). 

CHANNEL  PROVIDES  A  SOFTWARE  INTERFACE  TO  THE  I/O 
CHANNEL.  THIS  CHANNEL  CONSISTS  OF  A  CROMEMCO  MICRO¬ 
COMPUTER  WITH  THE  CHOPS  OPERATING  SYSTEM  INSTALLED  AND 
RUNNING  IN  IT.  CHANNEL  INITIATES  TASKS  AND  TRANSFERS 
DATA  ACCORDING  TO  THE  PROTOCOL  SETUP  FOR  THE  I/O 
CHANNEL.  IT  SHOULD  BE  NOTED  THAT  IF  CHOPS  IS  NOT 

RUNNING,  CHANNEL  WILL  HANG  AND  CTRL  A  MUST  BE  USED  TO 

RETURN  TO  THE  CLI. 


*»*  CHANNEL  VARIABLES  «** 

ABRTERR-  ABORT  ERROR.  USED  AS  BOTH  A  VARIABLE  AND 
A  FLAG,  MOST  SIGNIFICANT  BIT  IS  SET  WHEN 
ABORT  IS  INITIATED. 


CMD- 

DARRAY- 

DCHBLKS- 

DCMD- 

EOF- 

ERRBIT- 


COMMAND.  USEDTOSEND  I/OCHANNEL  COMMANDS 
SAME  AS  ABOVE. 

SAME  AS  ABOVE. 

DATA  COMMAND.  REQUIRED  BY  THE  I/O  CHANNEL 
PROTOCOL. 

END  OF  FILE.  USED  TO  DETECT  A  SYSTEM  EOF 
ERROR  (9). 

ERROR  BIT.  USED  TO  POINT  TO  THE  ERROR  BIT 
IN  THE  I/O  CHANNEL'S  STATUS  WORD. 


ERRMSK-  ERROR  MASK.  USED  TO  SEPARATE  OUT  THE 
ERROR  NIBBLE  FROM  THE  I/O  CHANNEL'S  STATUS 
WORD. 


ERROR-  SAME  AS  ABOVE. 


FILENAM-  SAME  AS  ABOVE. 


IER-  USED  TO  COLLECT  ANY  ERROR  RETURNED  BY  A 

SYSTEM  CALL. 


IMODE-  USED  TO  STORE  THE  MODE  WITH  OFFSET  OF  ONE 
FOR  COMPUTED  GOTO. 
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IPARRAY-  CONTAINS  WORKING  VERSION  OF  PARRAY  SO 
CHANGES  CAN  BE  MADE  WITHOUT  AFFECTING  THE 
ORIGINAL  ARRAY. 

ISTAT-  THIS  ARRAY  IS  USED  TO  STORE  THE  STATUS  OF 
FILENAM  OBTAINED  BY  CALLING  STATUS. 


ITASK- 


SAME  AS  ABOVE. 


MODE- 


SAME  AS  ABOVE. 


MSB-  MOST  SIGNIFICANT  BIT.  USED  TO  POINT  TO 

THE  MOST  SIGNIFICANT  BIT  OF  A  WORD. 


NOABRT- 


UNABLE  TO  ABORT  ERROR  CODE. 


PARRAY-  SAME  AS  ABOVE. 


PCNT- 


SAME  AS  ABOVE. 


PCNTMSK-  PARAMETER  COUNT  MASK.  USED  TO  EXTRACT  THE 
PARAMETER  COUNT  FROM  THE  I/O  CHANNEL'S 
STATUS  WORD. 

PCOUNT-  SAME  AS  ABOVE. 

RDOSERR-  RDOS  ERROR.  USED  TO  RETURN  RDOS  SYSTEM 
ERRORS. 

STATBIT-  STATUS  BIT.  USED  TO  POINT  TO  THE  STATUS 
BIT  OF  THE  I/O  CHANNEL  STATUS  WORD. 

STATUS-  USED  TO  RETURN  THE  I/O  CHANNEL  STATUS  WORD 

SYSERR-  SAME  AS  ABOVE. 

UFTBC-  NUMBER  OF  BYTES  IN  LAST  BLOCK  OF  FILENAM 
STORED  HERE. 


UFTBK- 


NUMBER  OF  LAST  BLOCK  IN  FILENAM  STORED 
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C*****«*«*********#*#**#«###c 

C  SETUP  CHANNEL  C 

c* •»***•***«««******•«*«**•«£ 


DIMENSION  PARRAY( 16) ,IPARRAY(16) , DARRAY ( DCOUNT ) , 
+ISTAT( 20 ) , FILENAM( 7 ) 

INTEGER  CMD, PCNT, PAR  RAY, STATUS, ERROR, MSB, ERRBIT, 
+PCNTMSK,STATBIT, ERRMSK, DARRAY, DCOUNT, DCMD, MODE, IER, 

+  ITASK,DIR, PCOU  NT , ABRTERR , ISTAT , DCHBLKS , UFTBK , UFTBC , 
+FILENAM,RDOSERR,SYSERR, IP ARRAY, NOABRT, EOF, I MODE 

LOGICAL  BTEST 

C«******»#*****#*»#»*****#****#**»c 

C  INITILIZE  VARIABLES  C 

c»**#»**«#**#**********«**********c 

DATA  ERRBIT/7/ , STATBIT/6/ ,MSB , PCNTMSK, ERRMSK/3* 1 5/  , 
+N0ABRT/255/, EOF/9/ 

SYSERR= 1 

ERROR=0 

ABRTERR=0 

CALL  BSET( RDOSERR ,MSB) 

C«***«***»*»»*«#***«*«*#»##*»#**«****»#»«*»#****c 

C  BOUNDS  CHECK  FOR  ARGUMENTS  PASSED  C 

c*#*«#*##***«*«#*«#*#*««#«***##»#******#**##*##»c 

IF(ITASK.GE.O.AND. I TASK. LE. 1 27 ) GO  TO  3 
ERR0R=ISHFT(2,8) 

RETURN 

3  IF ( DCOUNT. GE . 0 ) GO  TO  5 

ERROR=ISHFT(3,8) 

RETURN 

5  IF(DIR.GE.O.AND.DIR.LE.1)GO  TO  8 

ERROR=ISHFT(4,8) 

RETURN 

8  IF(MODE.GE. 0. AND. MODE. LE.3)G0  TO  10 

ERROR=ISHFT(5,8) 

RETURN 

10  IF(PCNT.GE.0.AND.PCNT.LE.15)G0  TO  12 

ERROR=ISHFT(6,8) 

RETURN 

12  IF(DCHBLKS.GE.O)GO  TO  15 

ERROR= ISHFT( 8,8) 

RETURN 
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£*******•**•*«**«•«*•**•«**•****•***«****•**««•£ 

C  FORM  COMMAND  WORD,  DATA  COMMAND,  C 

C  AND  SETUP  PCOUNT  AND  IPARRAY  C 

C#«#*##******«««#*#***«*#*»*#####*##****#*###«*(3 

15  CMD=ISHFT( I TASK, 8 ) . OR . ISHFT( DIR , 7 ) . OR. ISHFTC MODE , 4) 

C  **«  SET  MSB  OF  COMMAND  WORD 
CALL  BSET( CMD , MSB) 

DCMD=ISHFT(255,8).OR.CMD 

PCOUNTrPCNT 

IF(PCOUNT.EQ.O)GO  TO  40 
DO  20  1=1, PCOUNT 

IPARRAY(I)=PARRAY(I) 

20  CONTINUE 

C  SEND  COMMAND  WORD  C 

C*»»*»*»*»*»#»#*»****#*«»****#*#Q 

40  CALL  SANDS(CMD. OR. PCOUNT, STATUS) 

C  ***  CHECK  ERROR  FLAG  IN  I/O  CHANNEL’S  RESPONSE 
IF(. NOT. BTEST( STATUS, ERRB IT) )GO  TO  50 
ERROR=STATUS.AND.ERRMSK.OR.ISHFT(10,8).OR.ABRTERR 
RETURN 

50  IF((MODE.EQ.O).OR.(MODE.EQ.3))GO  TO  100 

C*«<HHt«**«««***«*««***X««*«***«****«**««******«*«****«««*«*C 

C  SETUP  TO  SEND  DATA  COUNT  FOR  MODE  1  OR  MODE  2  C 

IF( PCOUNT. EQ.O)GO  TO  80 

C  »**  ADD  DCOUNT  TO  BEGINNING  OF  PARAMETER  LIST 
DO  60  1=1 .PCOUNT 

I PARR AY (PC0UNT-I+2)=IPARRAY( PCOUNT- 1+1) 

60  CONTINUE 

80  PC0UNT=PC0UNT+1 

IPARRAY( 1)=DC0UNT 

cmmmimmMimHMHMiMmmMHMfi* 

C  CHECK  FOR  PARAMETERS  AND  SEND  THEM  IF  ANY 

100  IF( PCOUNT. EQ.O)GO  TO  300 

DO  200  1=1 .PCOUNT 

CALL  SANDS(IPARRAY(I) .STATUS) 

IF( . NOT. B TEST ( STATUS,ERRBIT))GO  TO  1 80 
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C  ***  PUT  PARAMETER  NUMBER  IN  PCNT  FOR  RETURN 
PCNT=I 

ERROR=STATUS. AND. ERRMSK. OR . ISHFTC 12,8) .OR.ABRTERR 
RETURN 

C  »**  IF  ALL  PARAMETERS  NOT  SENT  BUT  PCOUNT  IN  STATUS 

C  ***  IS  ZERO,  ABORT  TASK  AND  RETURN  AN  ERROR 

180  IF ( .NOT. ( (I. NE. PCOUNT) .AND. (( STATUS. AND. PCNTMSK) 

+.EQ.O)))GO  TO  200 

ERROR= STATUS. AND. ERRMSK.0R.ISHFT(I,4).0R.ISHFT 
+( 14, 8). OR.ABRTERR 
GO  TO  1000 

200  CONTINUE 

C  ***  ALL  PARAMETERS  SENT,  CHECK  FOR  0  PARAMETER 
C  »**  COUNT  FROM  I/O  CHANNEL 

IF( (STATUS. AND. PCNTMSK) . EQ.O)GO  TO  300 

ERROR= STATUS. AND. ERRMSK. OR . ISHFTC 1 6 , 8 ) . OR . ABRTERR 

GO  TO  1000 

cxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxc 

C  LOOK  FOR  DATA  TRANSFER  OR  DATA  CHANNEL  C 

CXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXC 

C  ***  OFFSET  MODE  BY  ONE  FOR  COMPUTED  GO  TO 
300  IM0DE=M0DE+1 

GO  TO  (400,2000,3000,400) ,IMODE 

CXXXXXXXXXXXXXXXXXXXXXXXXXXXXXQ 

C  WRAP  UP  COMMAND  C 

QXXXXXXXXXXXXXXXXXXXXXXXXXXXXXQ 

400  CALL  CANDR( STATUS) 

IF( . NOT.BTEST( STATUS, ERRBIT))GO  TO  420 

ERRORz STATUS. AND. ERRMSK. OR. ISHFTC 20 , 8 ). OR . ABRTERR 

RETURN 

C  *»*  IF  S  FLAG  SET,  RETURN 

420  IF(BTEST( STATUS, STATBIT) ) RETURN 

C  ***  ELSE  SEND  ERROR  AND  ABORT  CMD 
ERROR= ISHFTC  22,8) 

QXXXXXXXXXXXXXXXXXXXXXXKXXXXXXXXXQ 

C  TASK  ABORT  ROUTINE  C 

QXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXQ 

C  «**  IF  ABORT  IS  IN  PROGRESS  RETURN  "CANNOT  ABORT"  ERROR 
1000  IFCABRTERR. NE.O)GO  TO  1100 

C  *«*  SET  UP  TO  ABORT  AND  INITIATE  THE  CYCLE 
MODE=  3 


CMD  =  0 

ABRTERR= ISHFT( 1,15) 

ERROR=ABRTERR. OR. ERROR 
GO  TO  12 

C  «**  INSERT  "CANNOT  ABORT"  ERROR  AND  RETURN 
1 100  ERROR  =  ERROR. OR. ISHFT( NOABRT  ,  8) 

RETURN 

£xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx£ 

C  SEND  DATA  ROUTINE  C 

QXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXQ 

2000  DO  2200  1=1 .DCOUNT 

C  ***  SEND  DATA  COMMAND  ( DCMD ) 

CALL  SANDS(DCMD, STATUS) 

IF( . NOT. BTEST( STATUS, ERRB IT) )G0  TO  2100 
C  »**  RETURN  DATA  WORD  COUNT  IN  DCOUNT 
DCOUNT=I 

ERROR= STATUS. AND. ERRMSK. OR . ISHFT( 24 , 8 ) 
RETURN 

2100  IFCDIR.EQ. 1)G0  TO  2150 

C  IF  INPUT  GET  DATA  WORD 

CALL  CANDR( D ARRAY ( I ) ) 

GO  TO  2200 

C  ***  ELSE  SEND  A  DATA  WORD 

2150  CALL  SANDS(DARRAY(I) , STATUS) 

IF( . NOT. BTEST ( STATUS, ERRBIT)) GO  TO  2200 
C  ***  RETURN  DATA  WORD  COUNT  IN  DCOUNT 
DCOUNT=I 

ERROR=STATUS. AND. ERRMSK. OR. ISHFTC 26 ,8> 
RETURN 
2200  CONTINUE 

c  xxx  ip  DONE,  WRAP  IT  UP 

IF(BTEST( STATUS, STATBIT) )G0  TO  400 

C  ***  ELSE  ABORT  4  RETURN 
ERROR=ISHFT( 28,8) 

GO  TO  1000 

£XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX£ 

C  DATA  CHANNEL  ROUTINE  C 

CXXXXXXXXXKXXXXXXXXXXXXXXXXXXXXXXXXC 

C  «»«  DCOUNT  MUST  BE  16  OR  LESS  FOR  DCH 
3000  IF( DCOUNT. LE. 16) GO  TO  3020 

ERROR=ISHFT(30,8) 
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GO  TO  1000 

< 

3020  IF( DIR . EQ . 0 )GO  TO  3500 

C  DCH  TRANSMIT 

C  «*«**##*#### 

C  «««  GET  status  of  filenam  and  put  it  in  istat 

CALL  STATCFILENAM, ISTAT, IER)  ' 

IFCIER.EQ. 1)G0  TO  3120  \  | 

SYSERR= IER  \  ! 

ERR0R=ISHFT(31 ,8) 

GO  TO  1000 

I 

C  •«*  NUMBER  OF  LAST  BLOCK  IN  FILENAM  t 

3120  UFTBK=ISTAT(9)  I 

C  ***  NUMBER  OF  BYTES  IN  LAST  BLOCK  OF  FILENAM 
UFTBC=ISTAT( 10) 

C  «**  SEE  IF  FILENAM  IS  EMPTY 

IF( . NOT. ( ( UFTBK . EQ . 0 ) .AND. ( UFTBC. EQ . 0 ) ) ) GO  TO  3130 
ERROR=ISHFT(32,8) 

GO  TO  1000 

C  »**  MAKE  SURE  LAST  BLOCK  OF  FILENAM  IS  FULL  (512  BYTES) 

3130  IF(UFTBC.EQ.512)G0 ‘TO  3140 
ERROR=ISHFT(34,8) 

GO  TO  1000 

C  ***  IF  DCOUNT  IS  ZERO,  PUT  IN  DEFAULT  OF  4 
3140  IF (DCOUNT. NE.O)GO  TO  3180 
DCOUNTi 4 

/ 

C  ***  MAKE  SURE  FILENAM  IS  EVENLY  DIVISABLE  BY  DCOUNT, 

C  *«*  OFFSET  UFTBK  BY  ONE  SINCE  FIRST  BLOCK  IS  //ZERO 

3180  IH0LD  =  M0D(UFTBK+1  , DCOUNT) - * . . 

IF ( IHOLD. EQ . 0 )G0  TO  3200 
ERRQR=I3HFT( 35,8) 

GO  TO  1000 

C  «**  OPEN  FILENAM  ON  CHANNEL  4 
3200  CALL  0PEN(4, FILENAM, 2, IER) 

IF( IER. EQ . 1 )G0  TO  3220 

SYSERR=IER 

ERROR=ISHFT(36,8) 

GO  TO  1000 

C  «**  SEND  DATA  COMMAND  ( DCMD ) 

3220  CALL  SANDS(DCMD, STATUS) 

I F ( . NOT. B TEST ( STATUS, ERRBIT)) GO  TO  3240 
ERROR: STATUS. AND. ERRMSK. OR. ISHFT(38,8) 

RETURN 
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C  «««  INITIATE  DCH 

3240  CALL  DCHTX(DC0UNT, STATUS, RDOSERR) 

GO  TO  3565 
C  DCH  RECEIVE 

C  ftft*««****** 

C  ***  CREATE  RANDOM  FILE  IF  DCHBLKS  IS  0 
3500  I F ( DCHBLKS. EQ. 0 )G0  TO  3540 

C  «**  ELSE  CREATE  CONTIGUOUS  FILE 
C  »**  USING  DCHBLKS  FOR  BLOCK  COUNT 

CALL  CFILW(FILENAM,3 .DCHBLKS, IER) 

IF( IER. EQ. 1 )G0  TO  3560 

SYSERRrIER 

ERROR=ISHFT(40,8) 

GO  TO  1000 

3540  CALL  CFILW(FILENAM,2, IER) 

IF( IER. EQ . 1 .OR. IER. EQ . 12)G0  TO  3560 

SYSERRr IER 

ERR0R=ISHFT(42,8) 

GO  TO  1000 

C  «*«  OPEN  FILENAM  ON  CHANNEL  4 
3560  CALL  0PEN(4, FILENAM, 2, IER) 

IF(IER.EQ.1)G0  TO  3544 

SYSERRrIER 

ERROR=ISHFT(62,8) 

GO  TO  1000 

C  ***  SEND  DATA  COMMAND  ( DCMD ) 

3544  CALL  SANDS(DCMD, STATUS) 

IF( . NOT. BTESTC  STATUS , ERRBIT))GO  TO  3564 
ERROR= STATUS. AND. ERRMSK. OR. ISHFT( 46,8) 

RETURN 

C  «**  INITIATE  DCH 

3564  CALL  DCHRX(DCOUNT, STATUS, RDOSERR) 

C  WRAP  UP  DATA  CHANNEL 

C  »###**«»»«***»*»*#** 

C  ***  MAKE  RDOSERR  LIKE  FORTRAN  SYSTEM  ERRORS 

3565  SYSERR=RD0SERR+3 

C  ***  IF  MSB  OF  RDOSERR  SET,  NO  ERROR  SO  SYSERR  IS  ONE 
IF( BTESTC RDOSERR, MSB) )SYSERR=1 

C  ***  CLOSE  FILE  FIRST,  THEN  CHECK  FOR  ANY  DCH  ERRORS 
CALL  CLOSE( 4 , IER) 

IF( . NOT. BTEST ( STATUS, ERRBIT))GO  TO  3575 


ERROR=STATUS.AND.ERRMSK.OR.ISHFT(52,8) 

RETURN 

C  ***  IGNORE  "END  OF  FILE"  SYSTEM  ERROR 
C  ***  NOTE  THAT  SYSERR  IS  THE  MODIFIED  RDOSERR 
3575  IF((SYSERR.EQ. 1). OR. (SYSERR. EQ.EOF))GO  TO  3580 
ERROR=ISHFT(54,8) 

GO  TO  1000 

C  *«*  NOW  DO  CLOSE  FILE  ERROR  CHECK 
3580  IF( IER. EQ. 1 )G0  TO  3590 
SYSERR=IER 
ERR0R=ISHFT(50,8) 

GO  TO  1000 


C  *«*  SEND  DATA  COMMAND  (DCMD)  WITH  S  FLAG  SET 
3590  CALL  BSET(DCMD, STATBIT) 

CALL  SANDSCDCMD, STATUS) 

IF(. NOT. BTESTC STATUS, ERRBIT))GO  TO  3600 
ERRORr STATUS. AND. ERRMSK. OR. ISHFTC 56 , 8) 
RETURN 

C  ***  IF  DONE  WRAP  IT  UP 

3600  IF(BTEST( STATUS, STATBIT) )G0  TO  400 

C  ***  ELSE  ABORT  TASK 

ERROR= ISHFTC  58 , 8) 

GO  TO  1000 

END 
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NOVA/CROMEMCO 


CHANNEL  SUBROUTINE 


SANDS 


VERSION  1.1 


WRITTEN  BY 
CAPT  DAN  FREDAL,  USAF 
MARCH  1981 


SANDS  IS  A  FORTRAN  CALLABLE,  ASSEMBLY  LANGUAGE 
SUBROUTINE.  IT  SHOULD  BE  ASSEMBLED  WITH  DG • S  EXTENDED 
ASSEMBLER.  SANDS  IS  CALLED  AS  FOLLOWS: 

CALL  SANDSC CMDWRD, STATUS) 

CMDWRD-  THIS  ARGUMENT  IS  PASSED  TO  SANDS.  IT  IS  IN 
TURN  PLACED  IN  THE  C  PORT  OF  THE  I/O  CHANNEL. 

STATUS-  THIS  ARGUMENT  IS  RETURNED  BY  SANDS.  IT  IS 
THE  WORD  PLACED  IN  THE  C  PORT  BY  THE  I/O 
CHANNEL  AFTER  THE  DONE  FLAG  HAS  BEEN  SET. 

SANDS  PLACES  CMDWRD  IN  THE  C  PORT  OF  THE  I/O 
CHANNEL  AND  SETS  THE  BUSY  FLAG.  IT  THEN  WAITS  FOR  THE 
DONE  FLAG.  WHEN  IT  IS  SET,  SANDS  READS  THE  C  PORT  AND 
RETURNS  TO  THE  CALLING  ROUTINE. 

«*«***«***«*««««««**«**•***•«««*•«•*•*««*«•«••«*«**«*«« 


SET  UP  SANDS 

. TITL  SANDS 
.ENT  SANDS 
. EXTD  . FARL , . FRET 


.  NREL 
FS. 
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-V 


START  PROGRAM 


SANDS: 

JSR 

@.FARL 

; REQUIRED  TO  SETUP  FOR 
; FORTRAN  VARIABLES 

LDA 

0 , §TMP , 3 

;GET  WORD  FROM  CALLING 
; ROUTINE 

DOCS 

0,25 

; SEND  IT  TO  I/O  CHANNEL 
; AND  SET  BUSY 

TEST: 

SKPDN 

25 

; TEST  FOR  DONE  FLAG 

JMP 

TEST 

5  IF  FALSE,  TEST  AGAIN 

DIC 

0,25 

;GET  I/O  CHANNEL  STATUS 

STA 

0 , @TMP+ 1 , 3 

; RETURN  WORD  TO  CALLING  ROUTINE 

JSR 

FRET 

; RETURN  TO  MAIN  ROUTINE 

FS.  =2 

; FRAME  SIZE 

TMP=- 

167 

; ARGUMENT  OFFSET 

END 


SANDS 


NOVA/C  ROMEMCO 
CHANNEL  SUBROUTINE 


C  A  N  D  R 


VERSION  1.1 


WRITTEN  BY 
CAPT  DAN  FREDAL,  USAF 
MARCH  1981 


CANDR  IS  A  FORTRAN  CALLABLE,  ASSEMBLY  LANGUAGE 
SUBROUTINE.  IT  SHOULD  BE  ASSEMBLED  WITH  THE  DG  EXTENDED 
ASSEMBLER.  CANDR  IS  CALLED  AS  FOLLOWS: 

CALL  CANDR( STATUS) 

STATUS-  THIS  ARGUMENT  IS  RETURNED  BY  CANDR.  IT  IS 
THE  WORD  PLACED  IN  THE  C  PORT  BY  THE  I/O 
CHANNEL  AFTER  THE  DONE  FLAG  HAS  BEEN  SET. 


CANDR  CLEARS  THE  DONE  FLAG  AND  WAITS  FOR  THE  I/O 
CHANNEL  TO  SET  IT  AGAIN.  IT  THEN  READS  THE  C  PORT, 
CLEARS  BOTH  THE  BUSY  AND  DONE  FLAGS  AND  RETURNS  TO  THE 
CALLING  ROUTINE. 

it******************************************!*************** 


SET  UP  CANDR 


TITL 

CANDR 

ENT 

CANDR 

EXTD 

.FARL, .FRET 

NREL 

FS. 
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;  START  PROGRAM 
CANDR:  JSR  FARL 


NIOC 

25 

SKPDN 

25 

JMP 

.-1 

DICC 

0,25 

STA 

0 , @TMP , 3 

JSR 

e.FRET 

FS.rl 

TMP=- 

167 

.END  CANDR 


; REQUIRED  TO  SETUP 
; FOR  FORTRAN  VARIABLES 


; CLEAR  DONE  FLAG 

; TEST  FOR  DONE  FLAG 

;GET  STATUS  FROM  I/O  CHANNEL 
; AND  CLEAR  BUSY  AND  DONE 
;  PASS  IT  TO  CALLING  ROUTINE 
; RETURN  TO  MAIN  ROUTINE 

; FRAME  SIZE 
{VARIABLE  OFFSET 
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+++++++ 


NOVA/CROMEMCO 
CHANNEL  SUBROUTINE 


D  C  H  T  X 


VERSION  1.1 


WRITTEN  BY 
CAPT  DAN  FREDAL,  USAF 
MARCH  1981 


-  +  +  +  +  +  H 


-++++++ 


DCHTX  IS  A  FORTRAN  CALLABLE,  ASSEMBLY  LANGUAGE 
SUBROUTINE.  IT  SHOULD  BE  ASSEMBLED  WITH  THE  DG  EXTENDED 
ASSEMBLER.  DCHTX  IS  CALLED  AS  FOLLOWS: 

CALL  DCHTX(DCHBLKS, STATUS, RDOSERR) 

DCHBLKS-  THIS  ARGUMENT  IS  PASSED  TO  DCHTX.  IT  MUST 
CONTAIN  THE  NUMBER  OF  DISK  BLOCKS  WHICH  ARE 
TO  BE  BUFFERED  FOR  EACH  DATA  CHANNEL  ( DCH) 
TRANSFER  OF  DATA.  THIS  ARGUMENT  MUST  NOT 
BE  GREATER  THAN  16.  THE  CONTENTS  OF 
DCHBLKS  IS  DESTROYED  BY  DCHTX. 

STATUS-  THIS  ARGUMENT  IS  RETURNED  BY  DCHTX.  IT 
WILL  BE  THE  WORD  CONTAINED  IN  THE  C  PORT 
(I/O  CHANNEL  STATUS)  WHEN  DCHTX  WAS  EXITED. 

RDOSERR-  THIS  ARGUMENT  IS  RETURNED  BY  DCHTX.  IT 
WILL  CONTAIN  ANY  RDOS  SYSTEM  ERROR  WHICH 
OCCURRED  AS  A  RESULT  OF  CALLING  .IOPR,  OR 
. RDB.  RDOSERR  REMAINS  UNCHANGED  IF  NO 
SYSTEM  ERROR  OCCURS. 

DCHTX  TRANSFERS  DATA  FROM  THE  10  MBYTE  DISK  TO  THE 
I/O  CHANNEL  USING  DCH.  IT  FIRST  CLEARS  STATUS  AND  THEN 
GETS  THE  RDOS  EQUIVALENT  OF  FORTRAN  CHANNEL  §H.  DCHTX 
THEN  PROCEEDS  TO  TRANSFER  DATA  FROM  THE  DISK  TO  ONE  OF 
ITS  BUFFERS.  AT  THE  SAME  TIME,  DCHTX  HAS  THE  I/O 
CHANNEL  TRANSFERRING  DATA  FROM  ITS  OTHER  BUFFER.  ALL 
TRANSFERS  ARE  MADE  USING  DCH.  THIS  CONTINUES  UNTIL  AN 
ERROR  OCCURS  OR  THE  I/O  CHANNEL  INDICATES  IT  IS  DONE. 
DCHTX  CHECKS  THE  I/O  CHANNEL  STATUS  WORD  AFTER  EACH 


TRANSFER  FOR  THE  ERROR  OR  DONE  BIT.  IF  EITHER  IS  SET 
IT  RETURNS  THE  STATUS  WORD  IN  STATUS  AND  RETURNS  TO  THE 
CALLING  ROUTINE.  IF  A  SYSTEM  ERROR  OCCURS  WHILE 
READING  THE  DISK,  DCHTX  WAITS  FOR  THE  I/O  CHANNEL  TO 
COMPLETE  ITS  TRANSFER  AND  THEN  RETURNS  THE  SYSTEM  ERROR 
IN  RDOSERR  AND  THE  I/O  CHANNEL'S  STATUS  WORD  IN  STATUS. 
IT  THEN  RETURNS  TO  THE  CALLING  ROUTINE. 

JHtJHtXXXXXXXftXXKftXXXXXXXXXXXXXttftXftXXftttXXXXXXXXXftXXJHIXXXXXXXft 


SET  UP  DCHTX 

. TITL  DCHTX 

.ENT  DCHTX, .BUF1 ,.BUF2 

.  EXTD  .FARL, .FRET, . IOPR 

. ZREL  ; LOCATES  THE  FOLLOWING  ON  ZERO  PAGE 

. BUF1 :  BUFFI  ;PUT  BUFFER  POINTERS  ON  ZERO  PAGE 

. BUF2 :  BUFF2  ;SO  DCHRX.SR  CAN  GET  AT  THEM 

.  NREL  ; LOCATES  THE  FOLLOWING  NORMALLY 

FS. 


;  CONSTANTS 
THREE:  0 

START:  0 


STATMSK: 177440 


CHANNUM : 4 


BLKCNT :  0 


;  START  ROUTINE 
DCHTX:  JSR  @. FARL 


CLEAR  STATUS  (TMP+1)  SO 

ZERO  IS  RETURNED 

IF  NO  ERROR 

SUBO 

0,0 

; CLEAR  ACO 

ST  A 

0 ,@TMP+1 , 3 

READ  FIRST 

CHANNEL  BLOCK 

INTO  BUFFI 

LDA 

2, CHANNUM 

; PUT  FORTRAN 
; IN  AC2 

CHANNEL  NUMBER 

STA 

3 , THREE 

; SAVE  AC3 

SAVE  THREE  HERE 

FIRST  BLOCK  TO  BE  READ, 
STARTS  AT  BLOCK  ZERO 

STATUS  MASK-  CMD=FF , 
ERRORzO , STATUSzO ,MODE=2 

CHANNEL  THAT  FILE  IS 
OPENED  ON 

DCH  BLOCK  COUNT  STORED 
HERE,  THIS  IS  PASSED 
AS  AN  ARGUMENT 
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JSR 

@.IOPR 

;GET  MATCHING  RDOS  CHANNEL 
; NUMBER 

JMP 

ERROR 

; RETURN  ERROR  IF  ANY 

LDA 

3, THREE 

; RESTORE  AC 3 

LDA 

0,@TMP,3 

;GET  BLOCK  COUNT 

STA 

0 ,BLKCNT 

; SAVE  BLOCK  COUNT 

MOVS 

0,0 

; SWAP  IT  INTO  LEFT  HALF 
; OF  ACO 

COM 

0,0 

; OR  BLOCK 

AND 

0,2 

;  COUNT  WITH 

ADC 

0,2 

;  CHANNEL  NUMBER 

STA 

2 , §TMP , 3 

; PUT  THE  RESULT  BACK  FOR 
{LATER  REFERENCE 

LDA 

0 , . BUF1 

; POINT  TO  BUFFER  #1 

LDA 

1 , START 

{LOGICAL  BLOCK  TO  START 
{TRANSFER  WITH 

.SYSTM 

.  RDB 

77 

{WRITE  FILE  INTO  BUFFI 
{FROM  DISK 

JMP 

ERROR 

;  POINT  TO  BUFFI  AND  START  CHANNEL 
LOOP:  LDA  O..BUF1 

DOBC  0,25 

;  SET  UP  TO  READ  NEXT  CHANNEL  BLOCK  INTO  BUFF2 , 
;  THEN  DO  IT  ALL  AGAIN 


LDA 

2.BLKCNT 

{INCREMENT  LOGICAL  BLOCK 

ADD 

2,1 

{POINTER  BY  BLKCNT 

LDA 

2 , @TMP , 3 

{RESTORE  BLOCK  COUNT/CHANNEL 
{NUMBER  WORD 

LDA 

0 , . BUF2 

{POINT  TO  BUFFER  2 

READ  NEXT  CHANNEL  BLOCK  INTO  BUFF2  AND  WAIT  FOR  DONE 
. SYSTM 


.  RDB 

77 

{WRITE  TO  BUFF2 

JMP 

ERRDONE 

LDA 

0 , STATMSK 

{GET  READY  TO  CHECK 

{CHANNEL'S  STATUS 

SKPDN 

25 

{WAIT  TILL  I/O  CHANNEL 

JMP 

.-1 

;IS  DONE 

;  CHANNEL  DONE? 

DIC 

2,25 

{GET  STATUS  FROM  CHANNEL 

SUB 

2 , 0 , SZR 

;IF  NOT  DONE,  KEEP  GOING 

JMP 

RET 

{ELSE  RETURN 

;  POINT  TO  BUFF2  AND  START 

CHANNEL 

LDA 

0  , .  BUF2 
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DOBC 

0,25 

;  READ  NEXT 

CHANNEL  BLOCK 

INTO  BUFFI 

LDA 

2 ,BLKCNT 

;  INCREMENT  LOGICAL  BLOCK 

ADD 

2,1 

; POINTER  BY  BLKCNT 

LDA 

2 , @TMP , 3 

; RESTORE  BLOCK  COUNT/CHANNEL 
; NUMBER  WORD 

LDA 

0 , . BUF1 

; POINT  TO  START  OF  BUFFI 

:  READ  NEXT 

CHANNEL  BLOCK 

INTO  BUFFI  AND  WAIT  FOR  DONE 

. SYSTM 

.  RDB 

77 

; WRITE  TO  BUFFI 

JMP 

ERRDONE 

LDA 

0 , STATMSK 

;GET  READY  TO  CHECK 
; CHANNEL’ S  STATUS 

SKPDN 

25 

;WAIT  TILL  I/O  CHANNEL 

JMP 

.-1 

;  IS  DONE 

;  CHANNEL  DONE? 

DIC 

2,25 

;GET  STATUS  FROM  CHANNEL 

SUB 

2,0, SZR 

; IF  NOT  DONE,  DO  IT  ALL  AGAIN 

JMP 

RET 

; ELSE  RETURN 

JMP 

LOOP 

• 

;  ERROR  RETURN 

ERRDONE : SKPDN 

25 

;WAIT  TILL  I/O  CHANNEL 

JMP 

.-1 

; IS  DONE 

ERROR:  STA 

2 , @TMP+2 , 3 

; RETURN  RDOS  ERROR  TO 
; CALLING  ROUTINE 

DIC 

2,25 

;GET  CHANNEL'S  STATUS 

RET:  STA 

2 , @TMP+ 1 , 3 

; AND  RETURN  IT 

JSR 

FRET 

; RETURN  TO  CALLING  ROUTINE 

;  STORAGE  AREA 

BUFFI:  . BLK 

4096.  • 

; TWO  DATA  BUFFERS  FOR 

BUFF2 :  .BLK 

4096. 

; TRANSFER  OF  DATA  TO 

OR  FROM  I/O  CHANNEL.  EACH 
BUFFER  HOLDS  UP  TO  16 
BLOCKS  OF  DATA 


FS.=3 

; FRAME  SIZE 

TMP=- 167 

{VARIABLE  OFFSET 

END 


DCHTX 


+++++++++++++++ 


NOVA/C  ROMEMCO 
CHANNEL  SUBROUTINE 

D  C  H  R  X 

VERSION  1.1 


WRITTEN  BY 
CAPT  DAN  FREDAL,  USAF 
MARCH  1981 


DCHRX  IS  A  FORTRAN  CALLABLE,  ASSEMBLY  LANGUAGE 
SUBROUTINE.  IT  SHOULD  BE  ASSEMBLED  WITH  THE  DG  EXTENDED 
ASSEMBLER.  DCHRX  IS  CALLED  AS  FOLLOWS: 

CALL  DCHRX(DCHBLKS, STATUS, RDOSERR ) 

DCHBLKS-  THIS  ARGUMENT  IS  PASSED  TO  DCHRX.  IT  MUST 
CONTAIN  THE  NUMBER  OF  DISK  BLOCKS  WHICH  ARE 
TO  BE  BUFFERED  FOR  EACH  DATA  CHANNEL  (DCH) 
TRANSFER  OF  DATA.  THIS  ARGUMENT  MUST  NOT 
BE  GREATER  THAN  16.  THE  CONTENTS  OF 
DCHBLKS  IS  DESTROYED  BY  DCHRX. 

STATUS-  THIS  ARGUMENT  IS  RETURNED  BY  DCHRX.  IT 
WILL  BE  THE  WORD  CONTAINED  IN  THE  C  PORT 
(I/O  CHANNEL  STATUS)  WHEN  DCHRX  WAS  EXITED. 

RDOSERR-  THIS  ARGUMENT  IS  RETURNED  BY  DCHRX.  IT 
WILL  CONTAIN  ANY  RDOS  SYSTEM  ERROR  WHICH 
OCCURRED  AS  A  RESULT  OF  CALLING  .IOPR,  OR 
. WRB.  RDOSERR  REMAINS  UNCHANGED  IF  NO 
SYSTEM  ERROR  OCCURS. 

DCHRX  TRANSFERS  DATA  FROM  THE  I/O  CHANNEL  TO  THE  10 
MBYTE  DISK  USING  DCH.  IT  FIRST  CLEARS  STATUS  AND  THEN 
GETS  THE  RDOS  EQUIVALENT  OF  FORTRAN  CHANNEL  #4.  DCHRX 
THEN  PROCEEDS  TO  TRANSFER  DATA  FROM  THE  I/O  CHANNEL  TO 
ONE  OF  ITS  BUFFERS.  AT  THE  SAME  TIME,  DCHRX  WRITES  THE 
CONTENTS  OF  ITS  OTHER  BUFFER  TO  A  FILE  ON  THE  DISK.  ALL 
TRANSFERS  ARE  MADE  USING  DCH.  THIS  CONTINUES  UNTIL  AN 
ERROR  OCCURS  OR  THE  I/O  CHANNEL  INDICATES  IT  IS  DONE. 
DCHRX  CHECKS  THE  I/O  CHANNEL  STATUS  WORD  AFTER  EACH 
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TRANSFER  FOR  THE  ERROR  OR  DONE  BIT.  IF  EITHER  IS  SET 
IT  WRITES  THE  REMAINING  BUFFER  TO  THE  DISK  AND  RETURNS 
THE  STATUS  WORD  IN  STATUS  AND  RETURNS  TO  THE  CALLING 
ROUTINE.  IF  A  SYSTEM  ERROR  OCCURS  WHILE  WRITING  THE 
DISK,  DCHRX  WAITS  FOR  THE  I/O  CHANNEL  TO  COMPLETE  ITS 
TRANSFER  AND  THEN  RETURNS  THE  SYSTEM  ERROR  IN  RDOSERR 
AND  THE  I/O  CHANNEL'S  STATUS  WORD  IN  STATUS.  IT  THEN 
RETURNS  TO  THE  CALLING  ROUTINE. 

xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 


REQUIRED  SYSTEM  CALLS 


.  TITL 

DCHRX 

.  ENT 

DCHRX 

.  EXTD 
.  NREL 

FS. 

.FARL, .FRET, 

.  IOPR , . BUF1 , . BUF2 

;  CONSTANTS 

THREE:  0 

; SAVE  AC 3  HERE 

START:  0 

; FIRST  BLOCK  TO  BE  READ, 
-.STARTS  AT  BLOCK  ZERO 

STATMSK: 177440 

; STATUS  MASK-  CMD=FF, 

; ERR0R=0 , STATU S=0 , MODE =2 

CHANNUM : 4 

; CHANNEL  THAT  FILE  IS 
; OPENED  ON 

BLKCNT :  0 

; DCH  BLOCK  COUNT  STORED 
; HERE ,  THIS  IS  PASSED 
; AS  AN  ARGUMENT 

•  START  ROUTII\ 

t 

DCHRX:  JSR 

@.FARL 

:  CLEAR  STATUS  (TMP+1)  SO 

ZERO  IS  RETURNED  IF  NO  ERROR 

SUBO 

0,0 

; CLEAR  ACO 

STA 

0 , @TMP+1  ,3 

:  GET  RDOS  CHANNEL  NUMBER 

LDA 

2, CHANNUM 

; PUT  FORTRAN  CHANNEL  NUMBER 
; IN  AC2 

STA 

3, THREE 

; SAVE  AC3 

JSR 

§ . IOPR 

;GET  MATCHING  RDOS  CHANNEL 
; NUMBER 

JMP 

ERROR 

; RETURN  ERROR  IF  ANY 

LDA 

3, THREE 

; RESTORE  AC3 
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GET  AND  STORE  CH  BLOCK  COUNT, 


CREATE  BLOCK 

COUNT/CHANNEL 

WORD  FOR  AC2 

LDA 

0,@TMP,3 

GET  BLOCK  COUNT 

STA 

0, BLKCNT 

SAVE  BLOCK  COUNT 

MOVS 

0,0 

SWAP  IT  INTO  LEFT  HALF 

OF  AGO 

COM 

0,0 

OR  BLOCK 

AND 

0,2 

COUNT  WITH 

ADC 

0,2 

CHANNEL  NUMBER 

STA 

2 , @TMP , 3 

PUT  THE  RESULT  BACK  FOR 

LATER  REFERENCE 

SETUP  AC  1  SC 

BLOCK  POINTER 

WILL  START  AT  ZERO 

WHEN  BLKCNT 

IS  ADDED  TO  IT 

LDA 

1 , BLKCNT 

PUT  BLOCK  COUNT  IN  AC  1 

NEG 

1,1 

AND  NEGATE  IT 

POINT  TO  BUFFI  AND  START  CHANNEL 


LDA 

0 , . BUF1 

DOBC 

0,25 

LOOP 

:  SKPDN 

25 

; WAIT  FOR  DONE 

JMP 

.-1 

5 

CHANNEL  DONE? 

DIC 

2,25 

;GET  COMMAND  FROM  CHANNEL 

LDA 

0 ,  STATMSK 

; CHECK  ITS  STATUS 

SUB# 

2 , 0  ,  SZR 

; IF  NOT  DONE  GO  ON 

JMP 

B2RET 

; ELSE  RETURN 

POINT  TO  BUFF2  AND  START 

CHANNEL 

LDA 

0..BUF2 

DOBC 

0,25 

i 

WRITE  BUFFI 

ONTO  THE  DISK 

LDA 

2, BLKCNT 

; INCREMENT  LOGICAL  BLOCK 

ADD 

2,1 

; POINTER  BY  BLKCNT 

LDA 

2 , @TMP , 3 

; RESTORE  BLOCK  COUNT/CHANNEL 

; NUMBER  WORD 

LDA 

0..BUF1 

; POINT  TO  START  OF  BUFFI 

. SYSTM 

.  WRB 

77 

; WRITE  TO  FILE  ON  DISK 

; FROM  BUFFI 

JMP 

ERRDONE 

SKPDN 

25 

; WAIT  FOR  DONE 

JMP 

.-1 

• 

9 

CHANNEL  DONE? 

DIC 

2,25 

;GET  COMMAND  FROM  CHANNEL 

LDA 

0, STATMSK 

; CHECK  ITS  STATUS 

SUB 

2,0, SZR 

; IF  NOT  DONE  GO  ON 
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JMP 

B1  RET 

;  ELSE  RETURN 

5 

POINT  TO  BUFFI  AND  START 

CHANNEL 

LDA 

O..BUF1 

DOBC 

0,25 

5 

WRITE  BUFF2 

ONTO  THE  DISK 

AND  WAIT  FOR  DONE 

LDA 

2 , BLKCNT 

; INCREMENT  LOGICAL 

BLOCK 

ADD 

2,1 

; POINTER  BY  BLKCNT 

LDA 

2 , @TMP , 3 

: RESTORE  BLOCK  COUNT/CHANNEL 

; NUMBER  WORD 

LDA 

0..BUF2 

; POINT  TO  START  OF 

BUFF2 

. SYSTM 

. WRB  77  ; WRITE  TO  FILE  ON  DISK 

; FROM  BUFF2 

JMP  ERRDONE 

JMP  LOOP 

WRITE  BUFFI  ONTO  THE  DISK  AND  RETURN 


B1RET: 

LDA 

0 , . BUF1 

; POINT  TO  START  OF  BUFFI 

JMP 

BRET 

; AND  CONTINUE 

;  WRITE  BUFF2 

ONTO  THE  DISK 

AND  RETURN 

B2RET : 

LDA 

0 , . BUF2 

; POINT  TO  START  OF  BUFF2 

BRET: 

STA 

2,@TMP+1 ,3 

; RETURN  CHANNEL  ERROR  TO 
;  CALLING  ROUTINE 

LDA 

2, BLKCNT 

; INCREMENT  LOGICAL  BLOCK 

ADD 

2,1 

; POINTER  BY  BLKCNT 

LDA 

2 , @TMP , 3 

; RESTORE  BLOCK  COUNT/CHANNEL 
; NUMBER  WORD 

.SYSTM 

.WRB 

77 

; WRITE  TO  FILE  ON  DISK 

JSR 

@.  FRET 

; RETURN  TO  CALLING  ROUTINE 

;  ERROR  RETURN 

ERRDONE 

:  SKPDN 

25 

; WAIT  FOR  DONE 

JMP 

.>1 

ERROR: 

STA 

2 , @TMP+2 , 3 

; RETURN  RDOS  ERROR  TO 
; CALLING  ROUTINE 

DIC 

2,25 

;GET  AND  RETURN  CHANNEL'S 

STA 

2,@TMP+1 ,3 

; STATUS 

JSR 

@. FRET 

; RETURN  TO  CALLING  ROUTINE 

FS.  =3 
TMP=- 167 


END 


DCHRX 


t 


Appendix  E 


l/.Q  Channel  Communications  Protocol 

The  following  pages  provide  vertical  time-line  diagrams 
of  the  transactions  that  take  place  over  the  I/O  Channel 
data  path  during  the  execution  of  each  of  the  possible  mode 
commands.  It  should  be  noted  that,  in  order  to  provide 
insight  into  the  communication  protocol  utilized  by  the  I/O 
Channel  during  command  and  data  transfers,  these  diagrams 
illustrate  (inly  the  error-free  transfer  case.  The  response 
to  error  conditions  occurs  immediately  after  the  error  is 
detected.  If  all  possible  combinations  of  these 
possibilities  were  shown,  the  diagrams  would  become 
extremely  cumbersome.  For  further  information  on  the  error 
possibilities,  the  main  body  of  this  document  and  the 
appropriate  software  listings  should  be  consulted. 

The  quantities  enclosed  in  quotation  marks  indicate 
explanatory  comments  and  do  not  necessarily  represent  the 
actual  information  words  that  are  passed  over  the  data  path. 
The  quantities  enclosed  in  parenthesis  indicate  actions 
which  cause  the  Nova  BUSY  and  DONE  flags  to  be  either  set  or 
cleared . 

(SB)  =  Set  Nova  BUSY  flag. 

(SD)  =  Set  Nova  DONE  flag. 

(CD)  =  Clear  Nova  DONE  flag. 

(SBCD)  =  Set  Nova  BUSY  and  clear  Nova  DONE  flags. 

( SDCB)  =  Set'  Nova  DONE  and  clear  Nova  BUSY  flags. 
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The  remaining  abbreviations  in  the  diagrams  are  used  to 
depict  the  command  word  fields  and  the  values  to  be  loaded 


F  '  * 


into  these  fields. 


D  =  Command  Direction/Error  field. 

S  =  Command  Status  field. 

P  =  Command  Parameter  Count/Error  Code  field. 


TP  =  Total  parameter  count. 

RP  =  Remaining  parameter  count. 
1  =  Set  condition. 

0  =  Cleared  condition. 


i  • 
! ; 
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MODE  ”00"  COMMANDS  -  CROMEMCO  TO  PERIPHERAL  TASK 


UQM 

Task  Command 
with  D= 1  (SB) 

First  Parameter 
( SBCD) 

Next  Parameter 
(SBCD) 

"Continue  until  next 

Last  Parameter 
(SBCD) 

(CD) 

(CD) 


Echo  Task  Command 
with  P=TP  ( SDCB) 


Echo  Task  Command 
with  P=RP  (SDCB) 


Echo  Task  Command 
with  PrRP  (SDCB) 


to  last  parameter  is  sent" 


Echo  Task  Command 
with  P=0  (SDCB) 

"Execute  task" 

Echo  Task  Command 
with  S=1  (SD) 

"Await  Next  Command" 
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MODE  "00"  COMMANDS  -  PERIPHERAL  TO  CROMEMCO  TASK 


NOVA  CROMEMCO 

Task  Command 
with  D=0  (SB) 

Echo  Task  Command 
with  P=TP  ( SDCB) 

First  Parameter 
( SBCD) 

Echo  Task  Command 
with  P=RP  (SDCB) 

Next  Parameter 
(SBCD) 

Echo  Task  Command 
with  P=RP  (SDCB) 

"Continue  until  next  to  last  parameter  is  sent" 

Last  Parameter 
(SBCD) 

Echo  Task  Command 
with  P=0  (SDCB) 

(CD) 

"Execute  task" 


(CD) 


Echo  Task  Command 
with  S=1  (SD) 

"Await  Next  Command" 


1 
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MODE  "01"  COMMANDS  -  NOVA  TO  CROMEMCO  TRANSFER 


CROMEMCO 


Echo  Task  Command 
with  P=TP  ( SDCB) 


Echo  Task  Command 
with  P=TP  (SDCB) 


Echo  Task  Command 
with  P=RP  (SDCB) 


"Continue  until  next  to  last  parameter  is  sent" 


Last  Parameter 

(SBCD) 

Echo 

Task  Command 

with  P=0  (SDCB) 

Data  Command 
with  D= 1  (SBCD) 

Echo 

Data  Command 
(SDCB) 

First  Data  Word 

(SBCD) 

Echo 

Data  Command 
(SDCB) 

Data  Command 
with  D=1  (SBCD) 

Echo 

Data  Command 
(SDCB) 

Next  Data  Word 

(SBCD) 

Echo 

Data  Command 
(SDCB) 

"Continue  until  the  next  to  last  data  word  is  sent" 
Data  Command 
with  D= 1  ( SBCD) 

Echo  Data  Command 
(SDCB) 

Last  Data  Word 
(SBCD) 

Echo  Data  Command 
with  S=1  (SDCB) 

(CD) 

"Execute  Task" 

Echo  Task  Command 
with  S=1  (SD) 


NOVA 

Task  Command 
with  D= 1  (SB) 


Data  Word  Count  Parameter 
(SBCD) 


Next  Parameter 
(SBCD) 


(CD) 


"Await  Next  Command" 


MODE  ”01"  COMMANDS  -  CROMEMCO  TO  NOVA  TRANSFER 


mm 

Task  Command 
with  D=0  (SB) 

Echo  Task  Command 
with  P=TP  ( SDCB) 

Data  Word  Count  Parameter 
( SBCD ) 

Echo  Task  Command 
with  P=TP  (SDCB) 

Next  Parameter 
(SBCD) 

Echo  Task  Command 
with  P=RP  (SDCB) 

"Continue  until  next  to  last  parameter  is  sent" 
Last  Parameter 
(SBCD) 

Echo  Task  Command 

with  P=0  (SDCB) 

Data  Command  "Execute  task" 

with  D=0  (SBCD) 

Echo  Data  Command 
(SDCB) 

(CD) 

First  Data  Word 
(SD) 

Data  Command 
with  D=0  (SBCD) 

Echo  Data  Command 
(SDCB) 

(CD) 

Next  Data  Word 
(SD) 

Data  Command 
with  D=0  (SBCD) 

Echo  Data  Command 
(SDCB) 

"Continue  until  the  next  to  last  data  word  is  sent" 
Data  Command 
with  D=0  (SBCD) 

Echo  Data  Command 
with  S=1  (SDCB) 

(CD) 

Last  Data  Word 
(SD) 

(CD) 

Echo  Task  Command 
with  S= 1  (SD) 

(CD) 

"Await  Next  Command" 
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i 
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MODE  "10"  COMMANDS  -  NOVA  TO  CROMEMCO  TRANSFER 


NO.YA 

Task  Command 
with  D= 1  (SB) 

Echo  Task  Command 
with  T=TP  (SDCB) 

DCH  Block  Count  Parameter 
( SBCD ) 

Echo  Task  Command 
with  PsTP  (SDCB) 

Next  Parameter 
(SBCD) 

Echo  Task  Command 
with  P=RP  (SDCB) 


"Continue  until  next  to  last  parameter  is  sent" 

Last  Parameter 
(SBCD) 

Echo  Task  Command 
with  P=0  (SDCB) 

Data  Command 
with  D=1  (SBCD) 

Echo  Data  Command 
(SDCB) 

(CD) 

First  Data  Block 

•  Echo  Data  Command 

(SD) 

(CD) 

Next  Data  Block 

Echo  Data  Command 
(SD) 


"Continue  until  the  last  data  word  is  sent" 
Data  Command  with  D=1 


and  S=1  (SBCD) 
(CD) 


Echo  Data  Command 
with  S=1  (SDCB) 


"Execute  Task" 

Echo  Task  Command 
with  S=1  (SD) 


(CD) 


"Await  Next  Command" 
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MODE  "10"  COMMANDS  -  CROMEMCO  TO  NOVA  TRANSFER 

MOM  CROMEMCO 

Task  Command 
with  D=0  (SB) 

Echo  Task  Command 
with  P=TP  ( SDCB) 

DCH  Block  Count  Parameter 
( SBCD ) 

Echo  Task  Command 
with  P=TP  (SDCB) 

Next  Parameter 
(SBCD) 

Echo  Task  Command 
with  P=RP  (SDCB) 

"Continue  until  next  to  last  parameter  is  sent" 

Last  Parameter 
(SBCD) 

Echo  Task  Command 

with  P=0  (SDCB) 

Data  Command  "Execute  task" 

with  D=0  (SBCD) 

Echo  Data  Command 
(SDCB) 

(CD) 

First  Data  Block 
Echo  Data  Command 
(SD) 

(CD) 

Next  Data  Block 
Echo  Data  Command 
(SD) 

"Continue  until  the  last  data  word  is  sent" 

Data  Command  with  D=1 
and  S=1  (SBCD) 

Echo  Data  Command 
with  S=1  (SDCB) 

(CD) 

Echo  Task  Command 
with  S=1  (SD) 

(CD) 

"Await  Next  Command" 
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MODE  "11"  COMMANDS  -  CROMEMCO  TO  PERIPHERAL  TASK 


NOVA 

Task  Command 
with  D=1  (SB) 


First  Parameter 
( SBCD) 


Next  Parameter 
(SBCD) 


CROMEMCO 


Echo  Task  Command 
with  P=TP  ( SDCB) 


Echo  Task  Command 
with  P=RP  (SDCB) 


Echo  Task  Command 
with  P=RP  (SDCB) 


"Continue  until  next  to  last 

Last  Parameter 
(SBCD) 


(CD) 


parameter  is  sent" 


Echo  Task  Command 
with  P=0  (SDCB) 

"Abort  task" 

Echo  Task  Command 
with  S=1  (SD) 


(CD) 


"Await  Next  Command" 


MODE  "11"  COMMANDS  -  PERIPHERAL  TO  CROMEMCO  TASK 


mm 

Task  Command 
with  D=0  (SB) 

First  Parameter 
( SBCD ) 

Next  Parameter 
(SBCD) 

"Continue  until  next  to 

Last  Parameter 
(SBCD) 

(CD) 

(CD) 


CROMEMCO 


Echo  Task  Command 
with  P=TP  ( SDCB) 


Echo  Task  Command 
with  P=RP  (SDCB) 


Echo  Task  Command 
with  P=RP  (SDCB) 

last  parameter  is  sent" 


Echo  Task  Command 
with  P=0  (SDCB) 

"Abort  task" 

Echo  Task  Command 
with  S=1  (SD) 

"Await  Next  Command" 
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I/O  C  lianas!  Error  Codes 

The  CHANNEL  subroutine  returns  two  variables  (ERROR  and 
SYSERR)  that  indicate  errors  which  occur  during  I/O  Channel 
operations.  SYSERR  will  contain  any  RDOS  errors  generated 
during  a  call  to  a  system  subroutine  from  either  Fortran  or 
assembly  language.  A  value  of  one  is  returned  in  SYSERR  if 
no  RDOS  errors  occur.  All  RDOS  errors  returned  by  Fortran 
are  offset  by  a  factor  of  +3.  CHANNEL  also  offsets  RDOS 
errors  returned  from  its  assembly  language  routines  by  a 
factor  of  +3  to  maintain  consistency  with  the  FORTRAN 
errors.  The  appropriate  DG  manual  should  be  referenced  for 
an  explanation  of  the  RDOS  system  errors. 

The  error  information  returned  by  ERROR  is  generated 
from  error  checks  made  within  CHANNEL  and  the  CHOPS.  ERROR 
contains  two  fields.  Its  least  significant  byte  contains 
the  error  that  the  CHOPS  returns  while  its  most  significant 
byte  contains  the  error  returned  by  CHANNEL.  In  addition, 
if  ERROR  is  negative  or  its  most  significant  bit  is  set,  a 
command  abort  was  initiated  by  CHANNEL.  When  CHANNEL 
initiates  an  abort,  the  CHOPS  error  indicated  in  ERROR,  if 
any,  will  be  an  error  that  occurred  during  the  execution  of 
the  abort  command. 

The  following  list  has  the  decimal  value  of  the  error 
code  that  will  be  returned  in  ERROR'S  most  significant  byte. 
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ERROR  CODE 
0 
2 

3 

4 

5 

6 

8 

10 

12 

14 


16 

20 

22 

24 


26 


DESCRIPTION 
No  error  occurred. 

The  TASK  argument  passed  to  CHANNEL  was  out 
of  bounds  (TASK<0  or  TASK>127). 

The  DCOUNT  argument  passed  to  CHANNEL  was  out 
of  bounds  (DCOUNTCO). 

The  DIR  argument  passed  to  CHANNEL  was  out  of 
bounds  (DIRCO  or  DIR>1). 

The  MODE  argument  passed  to  CHANNEL  was  out 
of  bounds  (M0DEC0  or  M0DE>3). 

The  PCNT  argument  passed  to  CHANNEL  was  out 
of  bounds  (PCNT<0  or  PCNT>15). 

The  DCHBLKS  argument  passed  to  channel  was 
out  of  bounds  (DCHBLKS<0). 

The  CHOPS  returned  an  error  after  receiving 
the  command  word. 

The  CHOPS  returned  an  error  after  receiving  a 
parameter.  The  number  of  the  parameter  which 
caused  the  error  is  returned  in  PCNT. 

The  CHOPS  counted  down  the  parameters  faster 
than  CHANNEL.  The  CHANNEL  parameter  number 
where  this  occurred  is  passed  in  PCNT.  Task 
abort  initiated. 

The  CHOPS  did  not  finish  counting  the 
parameters  when  CHANNEL  did.  Task  abort 
initiated . 

The  CHOPS  returned  an  error  during  the 
execution  of  a  task. 

The  CHOPS  did  not  properly  terminate  the 
task.  Task  abort  initiated. 

Data  Transfer  error.  The  CHOPS  returned  an 
error  after  receiving  a  Data  Next  command. 
The  number  of  the  data  word  is  returned  in 
DCOUNT. 

Data  Transfer  error.  The  CHOPS  returned  an 
error  after  receiving  a  data  word.  The 
number  of  the  data  word  is  returned  in 
DCOUNT. 


69 


28 


Data  Transfer  error.  Data  Transfer  not 
terminated  properly  by  tne  CHOPS.  Task 
abort  initiated. 


30  DCH  Transfer  error.  DCOUNT  out  of  bounds 
(DC0UNT>16) . 

31  DCH  output  error.  System  error  returned  by 
subroutine  STAT.  Task  abort  initiated. 

32  DCH  output  error.  File  to  be  transferred  is 
empty.  Task  abort  initiated. 

34  DCH  output  error.  File  to  be  transferred 

does  not  fill  last  block.  Task  abort 
initiated. 

35  DCH  output  error.  File  to  be  transferred  not 
evenly  divisible  by  channel  block  count. 
Task  abort  initiated. 

36  DCH  output  error.  System  error  returned  by 
subroutine  OPEN.  Task  abort  initiated. 

38  DCH  output  error.  Error  returned  by  the 

CHOPS  after  receiving  the  Data  Command 
initiating  a  DCH  transfer. 

40  DCH  input  error.  System  error  returned  by 

subroutine  CFILW  (create  contiguous  file). 
Task  abort  initiated. 

42  DCH  input  error.  System  error  returned  by 

subroutine  CFILW  (create  random  file).  Task 
abort  initiated. 

44  DCH  input  error.  System  error  returned  by 

subroutine  OPEN.  Task  abort  initiated. 

46  DCH  input  error.  Error  returned  by  the  CHOPS 

after  Data  Command  sent. 

50  DCH  transfer  error.  System  error  returned  by 

subroutine  CLOSE.  Task  abort  initiated. 

5 2  DCH  transfer  error.  Error  returned  by  the 

CHOPS  during  DCH.  System  error  may  also  be 
returned. 

‘  .  DCH  transfer  error.  System  error  returned 

during  DCH.  This  error  may  be  generated  by 
subroutine  IOPR  or  by  RDOS  system  calls  .RDB 
(DCH  output)  or  .WRB  (DCH  input).  Task  abort 
is  initiated  as  a  result  of  this  error.  Note 
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that  CHANNEL  ignores  EOF  system  error 
(Fortran  error  #9);  however,  this  error  code 
will  be  returned  in  SYSERR.  In  addition,  if 
no  error  is  returned,  SYSERR  is  set  to  one. 

56  DCH  transfer  error.  Error  returned  by  the 

CHOPS  after  Data  Command  was  sent  to 
terminate  the  transfer. 

58  DCH  transfer  error.  DCH  transfer  not 

terminated  properly.  Task  abort  initiated. 

255  Unable  to  abort  task  in  I/O  Channel.  User 

must  depress  reset  on  the  Cromemco. 


The  following  list  contains  the  decimal  value  of  the 
CHOPS  error  code.  These  codes  are  returned  as  the  least 
significant  byte  of  the  ERROR  variable. 


ERROR  CODE  DESCRIPTION 

0  No  error  occurred. 

1  Not  a  command.  This  error  indicates  that 
the  CHOPS  was  waiting  for  a  command,  but  it 
received  a  word  from  the  Nova  that  did  not 
have  the  most  significant  bit  set. 

2  Invalid  command.  This  error  indicates  that 
a  valid  command  word  was  received,  but  that 
the  task  that  this  command  is  attempting  to 
invoke  has  not  yet  been  implemented. 

3  Invalid  parameter  count.  This  error  code 

indicates  that  the  requested  task  requires  a 
different  number  of  parameters  than  the 
number  of  parameters  indicated  in  the 

parameter  count  of  the  command  word. 

^  Parameter  expected.  This  error  code 

indicates  that  the  CHOPS  was  waiting  for  a 
parameter  word  which  has  its  most 
significant  bit  cleared  to  be  sent,  but  the 
word  that  was  received  had  the  most 
significant  bit  set. 

5  Parameter  out  of  range.  This  error  code 

indicates  that  the  received  parameter  is 
either  less  than  or  equal  to  the  preset  low 


bound  or  it  is  greater  than  the  preset  high 
bound  for  this  task. 

Invalid  command  mode.  This  error  code 
indicates  that  the  requested  mode  for  this 
command  is  not  implemented  by  the  task. 

Data  command  expected.  This  error  code 
indicates  that  the  CHOPS  was  in  a  data 
collection  routine  when  a  command  was 
received  that  it  did  not  recognize.  When 
this  occurs  the  data  transmission  is  no 
longer  properly  synchronized. 


8  Data  buffer  size  exceeded.  This  error  code 
indicates  that  the  data  buffer  allocated  by 
the  task  has  overflowed  and  that  the  excess 
data  has  probably  been  lost. 

9  Data  out  of  range.  This  error  code 
indicates  that  the  data  that  was  transmitted 
or  collected  is  either  larger  or  smaller 
than  the  values  expected  for  this  task. 

10  Requested  device  off-line.  This  error  code 

indicates  that  the  task  requires  the  use  of 
hardware  that  is  not  installed  or  that  does 
not  have  power  applied. 

11-15  Not  yet  defined. 


6 

7 
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Nova  G  PI 

Nova  Paddle 

Cromemco 

Signal 

M/M  fin 

Conn.  P1d 

Jask/Pin 

JJaipg 

NC 

1 

1/01 

Ground** 

5 

2 

1/03 

Ml  -  DCH  control 

70 

3 

1/05 

CLOCK  DATA 

2 

4 

1/07 

Nova  input  bit-0 

6 

5 

1/09 

Nova  input  bit-1 

1 

6 

1/11 

Nova  input  bit-2 

49A 

7 

1/13 

Nova  input  bit-3 

49 

8 

1/15 

Nova  input  bit-4 

48 

9 

1/17 

Nova  input  bit-5 

6A 

10 

1/19 

Nova  input  bit-6 

41 

11 

1/21 

Nova  input  bit-7 

7 

12 

1/23 

Nova  input  bit-8 

29 

13 

1/25 

Nova  input  bit-9 

34 

14 

1/27 

Nova  input  bit-10 

8 

15 

1/29 

Nova  input  bit-11 

8A 

16 

1/31 

Nova  input  bit-12 

10 

17 

1/33 

Nova  input  bit-13 

9 

18 

1/35 

Nova  input  bit-14 

57 

19 

1/37 

Nova  input  bit-15 

67 

20 

1/39 

DEVICE  COMPLETE# 

2A 

21 

1/41 

DCHREQ 

68A 

22 

1/43 

A  SELECT// 

3 

23 

1/45 

B  SELECT// 

68 

24 

1/47 

C  SELECT// 

4 

25 

1/49 

M0  -  DCH  OUT/// IN 

69 

26 

2/01 

no  connection 

70A 

27 

2/03 

no  connection 

4A 

28 

2/05 

DONE 

71 

29 

2/07 

Nova  output  bit-0 

72A 

30 

2/09 

Nova  output  bit-1 

72 

31 

2/11 

Nova  output  bit-2 

76 

32 

2/13 

Nova  output  bit-3 

83 

33 

2/15 

Nova  output  bit-4 

84A 

34 

2/17 

Nova  output  bit-5 

89 

35 

2/19 

Nova  output  bit-6 

93 

36 

2/21 

Nova  output  bit-7 

82 

37 

2/23 

Nova  output  bit-8 

131 

38 

2/25 

Nova  output  bit-9 

132A 

39 

2/27 

Nova  output  bit-10 

132 

40 

2/29 

Nova  output  bit-11 

133 

41 

2/31 

Nova  output  bit-12 

134A 

42 

2/33 

Nova  output  bit-13 

98A 

43 

2/35 

Nova  output  bit-14 

104 

44 

2/37 

Nova  output  bit-15 

134 

45 

2/39 

BUSY 

135 

46 

2/41 

DCHSEL*DCH0// 

1 36  A 

47 

2/43 

DCHSEL*DCHI  </ 

125 

48 

2/45 

DCHACK// 

136 

49 

2/47 

no  connection 

NC 

50 

2/49 

Nova  +5  volts 

••All 

Cromemco  interface  even  numbered 

pins  are  grounded. 
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